home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / xfd_v301.zip / XFDDOCEN.DOC < prev   
Text File  |  1992-05-31  |  247KB  |  4,793 lines
  1. ╔══════════════════════════════            ┌─────────────────┐
  2. ║ XFD  FileDoor for QBBS, SBBS             │    D.I.S.P.     │────┐
  3. ║      and RA alike system                 │                 │░░░░│
  4. ╟──────────────────────────────            │                 │░░░░│
  5. ║ (c) 1991  Robert W.van Hoeven            │ Dutch           │░░░░│
  6. ╟──────────────────────────────            │   Independent   │░░░░│
  7. ║ Release : 3.01                           │     ShareWare   │░░░░│
  8. ║ Rel.Date: 01th June 1992                 │       Programmer│░░░░│
  9. ╠══════════════════════════════            └─────────────────┘░░░░│
  10. ║                                          |    │░░░░░░░░░░░░░░░░░│
  11. ║                                          |    └─────────────────┘
  12. ║                                          |       ┌─────┐        |
  13. ║                                          |       │░░░░░│        |
  14. ║                                          |       └──┬──┘        |
  15. ║ Use the XFD.NEW file for a               |     ┌────┴────┐      |
  16. ║ reference of new options !!!             ------││││││ ═══│-------
  17. ║                                                └─────────┘
  18. ╠═══════════════════════════════
  19. ║ Address: Robert W. van Hoeven
  20. ║          PO. Box 131
  21. ║          1170 AC  Badhoevedorp
  22. ║          Nederland / Holland
  23. ╚═══════════════════════════════
  24.  
  25.  ┌───────┬─────────────────────────────────────────────────────────────┐
  26.  │   0   │ Table of contents                                           │
  27.  └───────┴─────────────────────────────────────────────────────────────┘
  28.  
  29.  1 ----    General information
  30.   1.1      Copyrights and License Agreement
  31.   1.2      Newer versions and contacting the author
  32.  
  33.  2 ----    Package description and requirements
  34.   2.1      Preface
  35.   2.2      Requirements
  36.   2.3      Included files
  37.   2.4      History
  38.   2.5      Introduction & specs
  39.  
  40.  3 ----    Installation description
  41.   3.1      Installation (general)
  42.   3.2      Installation in the BBS
  43.    3.2.1   Command-line options
  44.    3.2.2   Downloads
  45.    3.2.3   Uploads
  46.   3.3      FILEDOOR.CFG
  47.    3.3.1   The line-tags
  48.    3.3.2   Very special statements
  49.    3.3.3   Basic statements
  50.    3.3.4   Statements that define the environment that FILEDOOR uses
  51.            (paths)
  52.    3.3.5   Statements that define the logging-format
  53.    3.3.6   Other statements, not related to protocol definition
  54.    3.3.7   Filedoor's Protocol Definition
  55.   3.4      FD_UPD and FILEDOOR.UPD
  56.  
  57.  4 ----    Runtime information
  58.   4.1      Fast Modems
  59.   4.2      Multi-line operations
  60.   4.3      Swapping
  61.   4.4      FileDoor/DISP-compatible tag-file <tm>
  62.   4.5      File selection
  63.   4.6      Selection with wildcards
  64.   4.7      Sysop-to-User files
  65.   4.8      Local keyboard codes
  66.   4.9      FILES.CTL and BADFILES.CTL
  67.   4.10     FileDoor and conversion exits (MTA.EXE and others)
  68.  
  69.  5 ----    Version information and credits
  70.   5.1      The BETA-team
  71.   5.2      Credits
  72.   5.3      Version history
  73.   5.4      Copyright, Trademarks
  74.  
  75.  ┌───────┬─────────────────────────────────────────────────────────────┐
  76.  │   1   │ General information                                         │
  77.  └───────┴─────────────────────────────────────────────────────────────┘
  78.  
  79.  1.1 Copyrights and License Agreement
  80.  ────────────────────────────────────
  81.  
  82.  - When  we  refer  to  the  XFD-  and OFD-package, we mean the  program
  83.    called FileDoor  <tm> and  all related  documentation, support  files
  84.    and such, as combined in the release package;
  85.  
  86.  - Users of the XFD-package must accept this disclaimer of warranty:
  87.  
  88.  - The   XFD-package  is   supplied  as   is.    The  author   disclaims
  89.    all warranties, expressed or implied, including, without  limitation,
  90.    the warranties of merchantability   and of fitness  for  any purpose.
  91.    The  author   assumes   no   liability   for   damages,   direct   or
  92.    consequential, which may result from the use of the XFD-package;
  93.  
  94.  - The  XFD-package  is  a  "shareware  program"  and is provided at  no
  95.    charge to the user for evaluation.   Feel free to share it with  your
  96.    friends,  but  please  do  not  give  it  away  altered or as part of
  97.    another  system.   The  essence  of  "user-supported"  software is to
  98.    provide personal  computer users  with quality  software without high
  99.    prices, and yet to provide  incentive for programmers to continue  to
  100.    develop new products.
  101.  
  102.  - If  you find  this program  useful and  find that  you are  using and
  103.    continue the  use of  the XFD-package  after a  30 days trial period,
  104.    you must register the XFD-package as described below;
  105.  
  106.  - Non-commercial  users can  get a  license for  the usage  up to  this
  107.    release  of  the  XFD-package  by  sending  a postcard, stating their
  108.    name, address, country,  FIDO-address (if any)  and the release  they
  109.    are  using,  to  the  author  (Robert  W.  van Hoeven) on the address
  110.    mentioned  in  the  header  of  this documentation. So called 'closed
  111.    BBS's',  unless  they   are  for  commercial   usage,  are  seen   as
  112.    non-commercial users;
  113.  
  114.  - For commercial usage, the user must contact Robert W. van Hoeven (see
  115.    address in the header) for details;
  116.  
  117.  - The registration of the XFD-package will license ONE copy for use  on
  118.    any computer at any  one time, as long  as the usage confirms  to the
  119.    type of registration you have done (so NON-commercial usage when  you
  120.    have a non-commercial license);
  121.  
  122.  - Anyone  distributing  the  XFD-package  for any kind of  remuneration
  123.    must  first   contact  the   Author   at   the  address   above   for
  124.    authorization.
  125.  
  126.  - You are  encouraged  to  pass a copy   of the XFD-package  along   to
  127.    your friends  for  evaluation.   Please  encourage  them to  register
  128.    their copy if they find that they can use it;
  129.  
  130.  - Support  on  XFD,  when  used  in  a  non-commercial environment,  is
  131.    available  by  means  of  written  letters  or by entering the inter-
  132.    national echomail area DISP;
  133.  
  134.  - Problems and suggestions can be entered in the FidoNet <tm>  Echomail
  135.    conference <tm> called DISP (international). Entering this echo  does
  136.    not  exclude  you  of  the  duty  to register the XFD-package, though
  137.    users who evaluate the product can enter the echo for questions;
  138.  
  139.  - The  XFD-package, all  programs, the  documentation and support-files
  140.    is  copyrighted  1990,92  by  Robert  W.  van  Hoeven,  PO.  Box 131,
  141.    Badhoevedorp 1170AC, Holland. All  rights are reserved. You  may copy
  142.    this  package  for  backup  purposes.  Also  you  may  copy and share
  143.    unmodified copies of the whole package, providing that the  copyright
  144.    notice    is    reproduced    and    included    on    all    copies.
  145.    Excluded from this statement  are the support-files written  by other
  146.    authors.  Please  refer  to  the  documentation of these programs for
  147.    copyrights and license agreements;
  148.  
  149.  - It  is  forbidden  to  modify,  adapt,  translate, reverse  engineer,
  150.    decompile  and/or  disassemble  the  software  in  the   XFD-package.
  151.    Patching the medium at  places that carry the  software is seen as  a
  152.    program change and is also forbidden. It is forbidden to create a  so
  153.    called 'bypass' to skip the original introduction screens and  delay.
  154.    Also it is forbidden  to use such a  'bypass' unless supplied by  the
  155.    author (Robert W. van Hoeven) himself;
  156.  
  157.  - Performing  any  of  the  illegal  actions as stated in the  previous
  158.    lines,  is  a  theft  and  no  fair  play  to  the  author  and, more
  159.    important, to the registered users;
  160.  
  161.  - Bulletin Board  Systems that distribute  the XFD package  can convert
  162.    the WHOLE package  to any archive-system  they like but  all original
  163.    files must  be included  in the  new archive.  The XFD-package on the
  164.    Bulletin Board  can contain  at the  most 2  extra files. These files
  165.    can only be  a commercial for  that Bulletin Board  and/or validation
  166.    data that is presented  as a service to  all users and shall  have no
  167.    other functions;
  168.  
  169.  - After  the normal  trial period  of 30  days, you  must register  the
  170.    soft- ware (see REGISTER.XFD) or you must remove it from your PC;
  171.  
  172.  - Comments,  suggestions  and  bug  reports  are  welcome  and will  be
  173.    answered as soon I have the time  to do so. You can send me  a letter
  174.    of leave  a NetMail  <tm> message  named to  Rob Van.hoeven (mind the
  175.    point)  on  node  2:512/100  (RA  Support, Monster, Holland, SysOp is
  176.    Reinier de Groot).  When you want to send me normal mail, address  it
  177.    to:   Robert  W.  van  Hoeven,  PO.  Box  131,  1171 AC Badhoevedorp,
  178.    Holland;  Also  you  can  enter  messages  in  the  FidoNet <tm> DISP
  179.    Echomail <tm> area;
  180.  
  181.  
  182.  1.2 Newer versions and contacting the author
  183.  ───────────────────────────────────────────────────────────────────────
  184.  The newest version of  XFD is always available  at the DISP-HQ on  node
  185.  2:512/100.  XFD  is  also  distributed  thru  a  number of DISP support
  186.  nodes.  There are three ways of obtaining newer versions of XFD:
  187.  
  188.  
  189.  - Logging on at DISP-HQ or a support node
  190.    Look into the file SUPPORT.XFD for a full list of support nodes;
  191.  
  192.  - Logging on to a SDS node
  193.    XFD is distributed thru SDS/SDN, but only big minors (x.10, x.20  and
  194.    so on) and majors (14.01, 15.01  and so on) are submitted to  the SDS
  195.    distribution point in Holland;
  196.  
  197.  - Logging on to your own BBS;
  198.    Chances  are,  that  you  will  find  an older version (international
  199.    users) because it will take some time for the new version to  'bleed'
  200.    thru the net;
  201.  
  202.  
  203.  If you think you have found problems in XFD, or in any other case,  you
  204.  wish to contact the author, you can send me:
  205.  
  206.  - A letter to the address you can find in the header of this file;
  207.  
  208.  - A  NetMail  <tm>  message   to  Rob Van.hoeven (please mind the point
  209.    between Van and Hoeven) at 2:512/100 or (better) 2:512/100.5;
  210.  
  211.  - A Message in the FidoNet <tm> DISP echomail <tm> area;
  212.  
  213.  ┌───────┬─────────────────────────────────────────────────────────────┐
  214.  │   2   │ Package description and requirements                        │
  215.  └───────┴─────────────────────────────────────────────────────────────┘
  216.  
  217.  2.1 Preface
  218.  ───────────────────────────────────────────────────────────────────────
  219.  Please notice the following:
  220.  
  221.  - FileDoor is a ShareWare product  in every right way, this means  this
  222.    software is not crippled in any  way. Also FileDoor is FREE !  Only a
  223.    postcard and some stamps are needed to register FileDoor. It is  very
  224.    strange to see other  products call  themselves 'FileDoor compatible'
  225.    or 'FileDoor clone'  while they ask  money for the  program (and some
  226.    of the ideas from others);
  227.  
  228.  - Everyone is urged to register the program when using it for a  period
  229.    longer than 30 days;
  230.  
  231.  - This  program will  need the  actual protocol  drivers to work. These
  232.    are not supplied  in this package,  but are widely  available on most
  233.    BBS's.  Therefor  please  contact  the  author of the protocol driver
  234.    when you have  problems with the  driver. You may  contact the author
  235.    of FileDoor or one of the support boards when you have a question  on
  236.    how to install a certain file-transfer protocol in FileDoor. Also,  a
  237.    large number of users can  help you with the installation  of certain
  238.    protocols.  Refer  to  the   RA_UTIL  international  echomail.   Some
  239.    protocols include the settings for  FileDoor, but be sure that  these
  240.    are the correct ones and  are compatible with the current  release of
  241.    FileDoor. At the moment  there is one author  that has access to  the
  242.    latest FileDoor beta  releases to develop  his protocol. This  is the
  243.    author of the protocol called Zyrion <tm>;
  244.  
  245.  - If you have created a working example in FileDoor.CFG for a new  type
  246.    of protocol, I would like it very  much if you send me a copy  of the
  247.    actual  PROTOCOL-statement.  With  newer  releases, other can benefit
  248.    from this  knowledge. Your  name will  be added  to the  'what's new'
  249.    list at the bottom;
  250.  
  251.  
  252.  2.2 Requirements
  253.  ───────────────────────────────────────────────────────────────────────
  254.  FileDoor           - PC XT/AT/386;
  255.                     - At least 300K free memory for FileDoor to run.
  256.                       Some extra kBs are added for each file you select.
  257.                       Extra memory requirements are depending on the
  258.                       selected protocol driver;
  259.                     - DOS 3.xx and higher (tested with DOS 5.xx and 4Dos
  260.                       4.0);
  261.                     - A  BBS program  like Remote  Access <tm>, QuickBBS
  262.                       <tm>, SBBS  <tm> or  one that  is compatible  with
  263.                       one of the above BBS programs;
  264.                     - Optionally, MTA <tm> and MTS <tm> DISP products;
  265.  
  266.  
  267.  2.3 Included files
  268.  ───────────────────────────────────────────────────────────────────────
  269.  The package includes : FILEDOOR.EXE   The main program
  270.  
  271.                         FILE_OVR.EXE   The main program overlay version
  272.                         FILE_OVR.OVR   The overlay file for FILE_OVR.EXE
  273.  
  274.                         FILEDOOR.CFG   An example config file
  275.                         FILEDOOR.MUL   An example config file
  276.  
  277.                         BIMODEM.CFG    An example of Bimodem.CFG
  278.  
  279.                         XFD.NEW        What is new in current version
  280.                         XFDDOCEN.DOC   The documentation
  281.  
  282.                         REGISTER.XFD   Registration information
  283.                         REG_FORM.XFD   Registration form
  284.                         VENDOR.XFD     Vendor information
  285.                         README.XFD     Last minute information
  286.                         *.ANS          Example of ANSI -menu/Help files
  287.                         *.ASC          Example of ASCII-menu/Help files
  288.  
  289.  
  290.  2.4 History
  291.  ───────────────────────────────────────────────────────────────────────
  292.  FileDoor <tm> is an original  product from Stig Jacobsen.   His program
  293.  was a widely used protocol driver on many BBS's in all zones and  nets.
  294.  The  last  version  (v1.21)  was  released  in  1989  and  since   then
  295.  implemented in many  QuickBBS and Remote  Access BBS systems  (the last
  296.  be means of some tricks to fool Remote Access and FileDoor).
  297.  
  298.  All rights of  FileDoor and the  complete source code  were transferred
  299.  to  me  in  the  late  1990's.  Because  of  his  work  and  many other
  300.  activities Stig was not able  to release a much wanted  updated version
  301.  for the currently supported BBS systems and the newer ones.
  302.  
  303.  In the beginning I started to work with the original source code.   For
  304.  several reasons  this method  was abandoned  and I  decided to  write a
  305.  completely  new  version  from  scratch.  This  way I could use all the
  306.  experience  with  Turbo  Pascal  (my  second  native  language) and all
  307.  available commercial toolboxes.
  308.  
  309.  To accommodate the user with  the fastest performance that is  possible
  310.  in Pascal (Pascal implementations  are always use somewhat  more memory
  311.  and are somewhat slower than C implementations) a number of  registered
  312.  commercial  toolboxes  are  used  to  gain  in  speed and to reduce the
  313.  memory.  A complete  list of the used  products is found at  the end of
  314.  the document.
  315.  
  316.  The  current  version  of  FileDoor  is  a complete rewrite and extends
  317.  file-transfer options of  many BBS programs.  The tradeoff is  a bigger
  318.  memory consumption.  There are  several options  in FileDoor  3.xx that
  319.  were not available before and all these options will cost some  memory.
  320.  I  saw  no  problems  in  extending  the  memory usage because most BBS
  321.  programs now have a swap-option in their external calls (like the  type
  322.  7  *M  option)  and  for  those  BBS's  that  don't have these options,
  323.  FileDoor itself can  also swap before  a protocol is  called. It should
  324.  also be noticed that all ORIGINAL functions of FileDoor still are  (and
  325.  will stay) in the  program. The benefit is,  that you can easy  upgrade
  326.  to a newer  version, the tradeoff  is that the  basic point of  few can
  327.  not be altered.
  328.  
  329.  The current  version you  own will  work for  QuickBBS, Remote  Access,
  330.  SuperBBS and compatible  clones. A separate  package will be  available
  331.  soon (OFD_Vxxx)  that will  interface to  OPUS, Maximus  and compatible
  332.  clones. BBS programs  that have a  newer beta-version will  (sometimes)
  333.  not work if the internal  structures are changed. There is  only direct
  334.  access to  Remote Access's  <tm> beta  versions and  most of  the time,
  335.  FileDoor will  be able  to work  with the  newer beta  versions of this
  336.  program.
  337.  
  338.  A special word  for the current  FileDoor 2.xx <tm>  users. The current
  339.  version (3.01) has taken  some time. It has  been tested over and  over
  340.  to remove as much of the bugs in 2.03 as possible. Also there are  many
  341.  new features, in fact the number  of NEW features is around as  much as
  342.  the total  number of  features in  2.03. The  next release(s) will take
  343.  less time. Please  take a look  into chapter 2.6  to see some  previews
  344.  of the features I am working on right now !
  345.  
  346.  
  347.  2.5 Introduction & specs
  348.  ───────────────────────────────────────────────────────────────────────
  349.  FileDoor is an interface  to hook external file-transfer  programs into
  350.  Remote  Access,  QuickBBS  and  SBBS  or  compatible  clones  of  these
  351.  systems.
  352.  
  353.  FileDoor  will  add  features  and  flexibility  to transferring files,
  354.  which will not be found in any BBS or file-transfer interface.
  355.  
  356.  FileDoor has:
  357.  
  358.  - an interface to Remote Access, QuickBBS and SuperBBS systems.  Remote
  359.    Access 0.xx  and 1.xx  are both  supported as  are the  QuickBBS 2.xx
  360.    and SBBS 1.1x types;
  361.  
  362.  - full  security support,  including security  levels and  flags of the
  363.    above mentioned BBS programs;
  364.  
  365.  - support for the FILES.RA/FLSEARCH.CTL file;
  366.  
  367.  - support for FILES.CTL and BADFILES.CTL;
  368.  
  369.  - full multi-node, multitasking capabilities;
  370.  
  371.  - support  for many  (255) external  file-transfer protocols, including
  372.    those producing a DSZLog alike LOG file;
  373.  
  374.  - Built-in Fossil support;
  375.  
  376.  - support  for Bidirectional  transfer protocols (Bimodem and  HSLink);
  377.  
  378.  - support for CD-ROM systems when implemented in the BBS;
  379.  
  380.  - File-counter ([xx]) support;
  381.  
  382.  - user ratio monitoring;
  383.  
  384.  - direct updating in the BBS, if supported by the BBS;
  385.  
  386.  - support for external help and menu files;
  387.  
  388.  - ultra fast AutoSearch and in-archive file-view options;
  389.  
  390.  - an option to refuse 'unwanted' files. (*.GIF, ARJ230.EXE etc);
  391.  
  392.  - configurable download hours;
  393.  
  394.  - extended and user friendly interface to select files for transfer;
  395.  
  396.  - macro support;
  397.  
  398.  - several exit points for third party products;
  399.  
  400.  - a  direct  interface  for  semi-auto-download with the FileDoor/DISP
  401.    compatible tag-file options;
  402.  
  403.  - Retaining  the same  easy interface  for (the  much forgotten)  ASCII
  404.    user group;
  405.  
  406.  - all  those  options  not  found  in  most  BBS  program or any  other
  407.    transfer interface;
  408.  
  409.  - Interfaces to MTA, MTS and other DISP products;
  410.  
  411.  
  412.  2.6 Thoughts on FileDoor
  413.  ───────────────────────────────────────────────────────────────────────
  414.  I would like a moment of your  time to share with you the ideas  I have
  415.  about FileDoor and doors in general.
  416.  
  417.  When I took over FileDoor from  Stig I still found it the  most  useful
  418.  door ever  written for  QBBS/SBBS/RA BBS  systems. It  was easy to work
  419.  with, worked almost perfect and was  rather fast. The deal I made  with
  420.  Stig was that I should not alter the basic idea of the program. I  knew
  421.  that in advance and  agreed on this !  The FileDoor you see  before you
  422.  has still the same functional  skeleton as the older 1.21  (Stig's last
  423.  version). Some new functions are build AROUND this skeleton but do  not
  424.  replace it.
  425.  
  426.  My general idea  of doors is  much the same  as you see  in FileDoor. I
  427.  think that  a door  should be  designed to  complement a BBS's internal
  428.  feature or replace it with something much better. What I try not to  do
  429.  is to think  for the user.  In my opinion  it is much  better to have 4
  430.  doors,  each  complementing  each  other,  with  each bringing the best
  431.  there is, than to  have 1 general door  that can do everything.  Unless
  432.  very well written, those  doors will not give  you the best of  ALL the
  433.  functions or are better in some  and lesser in other. Also, such  doors
  434.  can better be converted to a BBS program itself because they force  you
  435.  only to use the BBS program as a skeleton and not as a BBS. If this  is
  436.  the case in  your implementation, you  should allow yourself  to recon-
  437.  sider if  you run  the right  BBS program  for your  taste. Given  this
  438.  (personal) idea,  I make  doors that  can complement  each other  (like
  439.  FileDoor, MTS and RFW) but still leave you free to replace one or  more
  440.  with a door that is more to your taste (eg. replace RFW with  something
  441.  else and still getting the best  from MTS and FileDoor). The main  goal
  442.  is to leave the choice to you and not to the program.
  443.  
  444.  Given this info, I don't have any problems with 'compatible' doors  and
  445.  certainly not  when they  fit more  into your  own BBS-environment.  If
  446.  there  is  a  GENERAL  demand  for  specific new features, they will be
  447.  implemented in  FileDoor. If  I find  something of  interest myself,  I
  448.  also will consider to  implement it.  So  the future of FileDoor  is up
  449.  to you.
  450.  
  451.  Version 3.01 will bring a lot of  new features that will be NEW at  the
  452.  moment of  release (clones  will duplicate  them soon).  There are also
  453.  a lot of features NOT implemented.  These are on the list for  the next
  454.  release (which by the way WON'T  take as long as this release).  One of
  455.  the main features  is language support  ! If you  are interested  in  a
  456.  multi-language transfer door at this  moment and it is a  feature which
  457.  you can't do without, switch to  another product ASAP, I don't mind.  I
  458.  want to have happy customers (even for the price of US $ 0,-- !!!) !
  459.  
  460.  
  461.  
  462.  ┌───────┬─────────────────────────────────────────────────────────────┐
  463.  │   3   │ Installation description                                    │
  464.  └───────┴─────────────────────────────────────────────────────────────┘
  465.  
  466.  3.1 Installation of files
  467.  ───────────────────────────────────────────────────────────────────────
  468.  Installing FileDoor  is quite  simple assuming  you have  read the  DOC
  469.  file. First read the  part on how to  install FileDoor.Exe in your  BBS
  470.  system,  then  carefully  read  the  part  about the configuration file
  471.  (FILEDOOR.CFG). When you  take the time  to read every  possible option
  472.  while creating  the control-file  you will  see that  everything is not
  473.  that difficult at all and you can get the most out of FileDoor.
  474.  
  475.  Installation can be done as follows:
  476.  
  477.  - Place  FILEDOOR.EXE and  FILEDOOR.CFG in  some directory  in the  DOS
  478.    PATH.   For  the  time  being,  do  the  same  with  FILEUSER.EXE and
  479.    FILEMAIN.EXE;
  480.  
  481.  - You must  decide if you  want to use  the normal version  (which will
  482.    take around  350K by  itself and  extending the  memory constraint if
  483.    you use many  features) or the  overlayed version (in  which case you
  484.    will have a  reduction of around  100K with the  disadvantage of some
  485.    loss in speed). If you use  the overlayed version, you should do  the
  486.    following:
  487.  
  488.    - Replace  FILEDOOR.EXE  by  FILE_OVR.EXE  and FILE_OVR.OVR. You  can
  489.      rename FILE_OVR.EXE to FILEDOOR.EXE  provided that you ALSO  rename
  490.      FILE_OVR.OVR to FILEDOOR.OVR;
  491.  
  492.    - You  can set  the environment  variable XFDOVRSZ  to some value. It
  493.      will be used by  the overlay version to  determine the size of  the
  494.      overlay buffer in conventional memory. The default value (which  is
  495.      around 32K)  will give  enough speed  but you  can extend the value
  496.      (SET XFDOVRSZ=50000 or another value) to gain some speed;
  497.  
  498.    - The overlay version will load  the overlay-file into EMS if EMS  is
  499.      available and there  is enough EMS-memory  free. If you  have don't
  500.      want  to  use  EMS  for  the  overlay,  you can set the environment
  501.      variable XFDOVROE to N (SET XFDOVROE=N);
  502.  
  503.  - Edit the FILEDOOR.CFG file in this directory (see instructions).   It
  504.    is possible to use  one FILEDOOR.CFx file for  each line you run  but
  505.    you can also create ONE FILEDOOR.CFG for all lines (see later);
  506.  
  507.  - Take special care with memory requirements (see later);
  508.  
  509.  - Be sure  to set DSZLOG  to a valid  directory and filename  (for each
  510.    line a  separate file  or separate  directory). Read  4.2 in  case of
  511.    doubt;
  512.  
  513.  FileDoor.CFG can be found in the following ways:
  514.  
  515.  - -C[drive:][\path\][filename] on the type 7/15 menu command-line;
  516.  
  517.  - In  the current  directory, the  directory FileDoor.EXE  was executed
  518.    from or the DOS PATH (in that order);
  519.  
  520.  - From an environment variable FILEDOOR:
  521.  
  522.    SET FILEDOOR=[drive][\path\]           to show the directory    where
  523.                                           FileDoor.CFG    is     located
  524.                                           (don't  forget  the   trailing
  525.                                           backslash)
  526.  
  527.    SET FILEDOOR=[drive][\path\][filename] to show  path and file to  use
  528.                                           as configuration file;
  529.  
  530.  
  531.  3.2 Installation in the BBS
  532.  ───────────────────────────────────────────────────────────────────────
  533.  The program is installed as a type  7 (shell to file) or type 15  (exit
  534.  to DOS) in your  Remote Access/QuickBBS/SuperBBS menu. Although  a type
  535.  7 exit is faster and much  easier to install, it will use  more memory.
  536.  So depending on your hardware you must either choose for a type 7 or  a
  537.  type 15 exit.  Both  the DORINFOx.DEF and EXITINFO.BBS file  are needed
  538.  by FileDoor. Depending  on your hardware  limitations you may  also use
  539.  the swap-to-memory or disk option of your specific BBS program.
  540.  
  541.  Some general hints while implementing FileDoor <tm> into a BBS:
  542.  
  543.  - Either use one download menu  for each file-area you have or  use the
  544.    same  download  menu  in  all  areas  when you install the AutoSearch
  545.    option  into   FileDoor.CFG  (advised).   With  AutoSearch   enabled,
  546.    FileDoor will track  the security to  determine from which  areas the
  547.    user can or may not download;
  548.  
  549.  - Use at  least one upload  (-DU) menu for  each file-area. The  upload
  550.    menus can point to the same or different upload directories;
  551.  
  552.  - Never allow uploads  to be available for  download at once. This  can
  553.    cause a 'flow' of illegal  (commercial) software on your BBS  and any
  554.    infected file  (viri) can  be downloaded  at once.  It will only give
  555.    YOU (and not the  uploader which in most  cases will be a  fake-user)
  556.    troubles;
  557.  
  558.  - Previous releases  of FileDoor <tm>  (2.01, 2.02(a) and  2.03) had an
  559.    option for bi-directional protocols.  This option is removed  and the
  560.    bi-directional protocols can  now reside in  the download AND  upload
  561.    menus (-DD and -DU).  In either case, the  user is free to  choose if
  562.    she/he wants to download and/or upload, independent from the type  of
  563.    menu (-DD or -DU) but ONLY for bi-directional protocols;
  564.  
  565.  - When possible, use the memory  swapping option of your BBS (*M).   It
  566.    will  cause  the  BBS  to  swap  from  memory,  leaving more room for
  567.    FileDoor  <tm>  and  its  options  of  which  most will be put on the
  568.    dynamic (conventional) memory (heap).  Also inside FileDoor <tm>  you
  569.    have  the  option  to  swap  the  FileDoor  out  of memory before the
  570.    protocol is fetched, leaving more memory for huge memory  consumptive
  571.    protocols (like Bimodem);
  572.  
  573.  The installation inside the BBS  program is simple. The only  thing you
  574.  have to take care of,  are the correct switches (command-line  options)
  575.  and the specific menu-syntax for your own BBS program.
  576.  
  577.  
  578.  3.2 Command-line switches
  579.  ───────────────────────────────────────────────────────────────────────
  580.  FileDoor  <tm>  can  use  the  following command-line switches of which
  581.  some are optional and some are mandatory:
  582.  
  583.  ┌─────────────────────────────────────────────────────────────────────┐
  584.  │ -DD                                                                 │
  585.  │ -DU                                                                 │
  586.  └─────────────────────────────────────────────────────────────────────┘
  587.  Function: One  of these  two switches  (but only  one) MUST be present.
  588.            Use -DD in  the call to  FileDoor <tm> that  is used for  the
  589.            download and  use -DU  in the  call that  is used for upload.
  590.            The old -DB option (do Bimodem) is removed from FileDoor  and
  591.            should be replaced by either -DD or -DU;
  592.  
  593.  ┌─────────────────────────────────────────────────────────────────────┐
  594.  │ -A[directory]                                                       │
  595.  └─────────────────────────────────────────────────────────────────────┘
  596.  Function: This option  is only needed  when you do  NOT set the  option
  597.            AutoSearch  in  FileDoor.CFG.  If  this case [directory] will
  598.            point  to  the  directory  from  which  files are downloaded.
  599.            This is  only needed  when you  have separate  FileDoor menus
  600.            for separate file-areas (not  recommended). When you use  the
  601.            AutoSearch option in  FileDoor.CFG you can  leave out the  -A
  602.            command-line option (or it will be ignored);
  603.  
  604.  ┌─────────────────────────────────────────────────────────────────────┐
  605.  │ -U[directory]                                                       │
  606.  └─────────────────────────────────────────────────────────────────────┘
  607.  Function: This option is only needed when you force FileDoor <tm>  into
  608.            upload-mode  (-DU)  or  you  use  one  or more bi-directional
  609.            protocols (Bimodem <tm>,  HSLink <tm>) in  download-mode. The
  610.            command-line option must point to the directory in which  the
  611.            uploads will be placed  (normal non-private uploads). If  the
  612.            FileDoor <tm>  program does  not need  the option  but it  is
  613.            still  present  on  the  command-line,  it  will  ignore  the
  614.            option.  If you include the upload-directory as an option  in
  615.            the CFG-file, you can leave out the -U.
  616.  
  617.  ┌─────────────────────────────────────────────────────────────────────┐
  618.  │ -P[directory]                                                       │
  619.  └─────────────────────────────────────────────────────────────────────┘
  620.  Function: This option is only needed when you force FileDoor <tm>  into
  621.            upload-mode  (-DU)  or  you  use  one  or more bi-directional
  622.            protocols (Bimodem  <tm>, HSLink  <tm>) in  download-mode AND
  623.            you  allow  PRIVATE  uploads.   The  command-line option must
  624.            point to the directory in  which the PRIVATE uploads will  be
  625.            placed  (not  the  normal  uploads).   uploads will be placed
  626.            (normal non-private uploads).   If the FileDoor <tm>  program
  627.            does  not  need  the  option  but  it is still present on the
  628.            command-line, it will ignore the option.  If you include  the
  629.            private upload-directory  as an  option in  the CFG-file, you
  630.            can leave out the -P.
  631.  
  632.  ┌─────────────────────────────────────────────────────────────────────┐
  633.  │ -N[line]                                                            │
  634.  └─────────────────────────────────────────────────────────────────────┘
  635.  Function: When you have  a BBS with multiple  lines, you must set  this
  636.            command-line option to the  line on which this  FileDoor <tm>
  637.            is running.  Most QBBS/RA/SBBS  alike BBS's  have a  macro in
  638.            the  menu-type  7  which  will  be  substituted by the actual
  639.            line-number  (*N  in  most  cases).  Some  Remote Access <tm>
  640.            versions don't allow the usage  of this macro more than  once
  641.            (so -N*N -CFILEDOOR.CF*N  for line 1  will be substituted  by
  642.            RA into -N1 -CFILEDOOR.CF*N, as you see the second *N is  not
  643.            replaced by '1'). In this  case it is advised that  you DON'T
  644.            use  the  -N  command-line  option  but the BBSLine option in
  645.            FileDoor.CFG.  In  this  case,  you  create a FileDoor.CFG of
  646.            each line (FileDoor.CF1, FileDoor.CF2 and so on) and you  use
  647.            the -CFILEDOOR.CF*N  (without -N*N)  to point  to the correct
  648.            CFG-file. Inside this CFG-files  you have placed the  BBSLine
  649.            option.
  650.  
  651.            If you  use only  one CFG-file  for several  lines (using the
  652.            special  syntax  described  later),  you  MUST  use  the   -N
  653.            command-line option !
  654.  
  655.  ┌─────────────────────────────────────────────────────────────────────┐
  656.  │ -C[path]                                                            │
  657.  └─────────────────────────────────────────────────────────────────────┘
  658.  Function: With this command-line option, you can point to an  alternate
  659.            CFG-file. This  comes in  handy with  multi-line setups.  You
  660.            can use  the special  BBS-macro's to  point to  various lines
  661.            (e.g. -CC:\FILEDOOR\FILEDOOR.CF*N) or to an alternate CFG  to
  662.            make a difference between  normal modems and locked  (HST and
  663.            such) modems.  You can  use the  combination of  -N and -C or
  664.            one of the  both and in  combination with FileDoor's  special
  665.            syntax for the CFG-file to  gain the optimal result (see  the
  666.            examples FILEDOOR.CFG  and FILEDOOR.MUL  in the  distribution
  667.            archive).
  668.  
  669.  ┌─────────────────────────────────────────────────────────────────────┐
  670.  │ -F[path]                                                            │
  671.  └─────────────────────────────────────────────────────────────────────┘
  672.  Function: You can use FileDoor <tm>  to force the download of a  single
  673.            (pre-assigned) file like the ALLFILES.xxx file. In this  case
  674.            you must create a separate  menu where you use the  -F option
  675.            to point  to the  drive, directory  and name  of the  file in
  676.            question  (e.g.  -FC:\MYFILES\ALLFILES.ZIP).  If  you  do not
  677.            include the -X command-line  option, the user will  come into
  678.            the menu  where she/he  can select  the protocol.  After this
  679.            selection, the transfer can be  started at once and there  is
  680.            no option select  other files. The  -F is even  enhanced. You
  681.            can also  include a  file-mask (with  wildcards) so  multiple
  682.            files can be downloaded in one run;
  683.  
  684.  
  685.  ┌─────────────────────────────────────────────────────────────────────┐
  686.  │ -X[protocol-letter]                                                 │
  687.  └─────────────────────────────────────────────────────────────────────┘
  688.  Function: This command-line option can be used in combination with  the
  689.            -F  command-line  option  (but  also  stand-alone). It can be
  690.            used to  pre-determine the  type of  protocol to  use. Though
  691.            useless in most  cases, it IS  possible to pre-determine  the
  692.            type  of  protocol  from  the  SysOp's  point  of  view. When
  693.            available, [protocol-letter]  must be  the letter  of one  of
  694.            the  protocols  that  you  implemented  in FileDoor <tm>. The
  695.            user  will  NOT  have  the  option  to  select  a protocol of
  696.            her/his own !
  697.  
  698.  ┌─────────────────────────────────────────────────────────────────────┐
  699.  │ -L[path]                                                            │
  700.  └─────────────────────────────────────────────────────────────────────┘
  701.  Function: This command-line  option can be  used to set  (overrule) the
  702.            place and name  of the FileDoor  <tm> log-file. Normally  you
  703.            will  set  the  location  and  name  of  the log-file with an
  704.            option  in  FileDoor.CFG  but  you  can use this command-line
  705.            option to  overrule the  value you  set in  the FileDoor.CFG.
  706.            Some BBS programs  have a macro  in the menu-interface  which
  707.            will be  substituted with  the full  path to  the BBS-log. In
  708.            these cases the -L command-line option comes in handy.
  709.  
  710.  
  711.  3.2.2 Download
  712.  ───────────────────────────────────────────────────────────────────────
  713.  When  installing   FILEDOOR.EXE  for   downloads  in   Remote   Access,
  714.  QuickBBS or SuperBBS as a  type 7 exit, the  optional datafield  should
  715.  at  least contain the following:
  716.  
  717.  [Drive:\Path\]FILEDOOR.EXE -DD -A[directory] {swap-macro}
  718.  
  719.  The  -A  switch  may  be  omitted  when you have the AutoSearch feature
  720.  enabled.
  721.  
  722.  FileDoor  will  use  all  BBS  program  specific files like FILES.RA in
  723.  Remote Access environment to do security locking.  As mentioned  before
  724.  you may also use the switch to  swap your BBS program for a large  part
  725.  to EMS/Disk ({swap-macro} which is *M  in most cases).  An example  for
  726.  Remote Access <tm>:
  727.  
  728.  FILEDOOR.EXE -DD -CFILEDOOR.CF*N -AC:\BBS\FILES\DISP *M
  729.  
  730.  The *N  option will  be used  to select  between different FILEDOOR.CF?
  731.  files for  the different  lines. *M  is used  to swap  the largest part
  732.  Remote Access  to EMS/Disk.  When you  run a  single-line BBS,  you can
  733.  leave out the *N and use  -CFILEDOOR.CFG or even leave that option  out
  734.  if FileDoor can find the CFG-file on its own.
  735.  
  736.  IMPORTANT: SuperBBS users  MUST use the  *E options both  for a type  7
  737.             and a type 15 exit  to reload the EXITINFO information  back
  738.             to the BBS;
  739.  
  740.  When you use  a type 15  exit then you  must change your  batch file in
  741.  such  a  way  that  after  exiting  with  an errorlevel you jump to the
  742.  routine that  will start  FILEDOOR.EXE. This  way you  MUST supply  all
  743.  parameters on the command-line. Also the  usage of -R is advised as  it
  744.  will reload the information from EXITINFO.BBS back to the BBS.
  745.  
  746.  
  747.  3.2.2 Upload
  748.  ───────────────────────────────────────────────────────────────────────
  749.  When installing FILEDOOR.EXE for  uploads in Remote Access, QuickBBS or
  750.  SuperBBS  as  a  type  7  exit,  the optional datafield should at least
  751.  contain the following:
  752.  
  753.  [Drive:\Path\]FILEDOOR.EXE -DU {-U[directory]} {swap-macro}
  754.  
  755.  The -U switch  may be omitted  when you have  set the proper  option in
  756.  the CFG-file. This also goes for  -P (not included above) which can  be
  757.  set  by  means  of  an  option  in  the  CFG-file  or  by  using the -P
  758.  command-line option.
  759.  
  760.  FileDoor  will  use  all  BBS  program  specific files like FILES.RA in
  761.  Remote Access environment  to do  security locking. As mentioned before
  762.  you may also use the switch to  swap your BBS program for a large  part
  763.  to EMS/Disk ({swap-macro}  which is *M  in most cases).  An example for
  764.  Remote Access <tm>:
  765.  
  766.  FILEDOOR.EXE -DU -CFILEDOOR.CF*N -UC:\BBS\FILES\UPLOAD *M
  767.  
  768.  The *N  option will  be used  to select  between different FILEDOOR.CF?
  769.  files for  the different  lines. *M  is used  to swap  the largest part
  770.  Remote Access  to EMS/Disk.  When you  run a  single-line BBS,  you can
  771.  leave out the *N and use  -CFILEDOOR.CFG or even leave that option  out
  772.  if FileDoor can find the CFG-file on its own.
  773.  
  774.  IMPORTANT: SuperBBS users  MUST use the  *E options both  for a type  7
  775.             and a type 15 exit  to reload the EXITINFO information  back
  776.             to the BBS;
  777.  
  778.  When you use  a type 15  exit then you  must change your  batch file in
  779.  such  a  way  that  after  exiting  with  an errorlevel you jump to the
  780.  routine that  will start  FILEDOOR.EXE. This  way you  MUST supply  all
  781.  parameters on the command-line. Also the  usage of -R is advised as  it
  782.  will reload the information from EXITINFO.BBS back to the BBS.
  783.  
  784.  
  785.  3.3 FILEDOOR.CFG
  786.  ───────────────────────────────────────────────────────────────────────
  787.  The  FILEDOOR.CFG  file  is  a  normal  text-file (ASCII-file). You can
  788.  create  this  file  with  programs  like  EDLIN  or  any  other  normal
  789.  ASCII-editor.   FileDoor  <tm>  will  search  for  its  CFG-file in the
  790.  following way:
  791.  
  792.  - If the -C command-line option is included, this one is used;
  793.  
  794.  - If the  environment variable FILEDOOR  is set to  a directory (not  a
  795.    filename),  FileDoor  <tm>  will  search  for  FILEDOOR.CFG  in  that
  796.    directory;
  797.  
  798.  - If the  environment variable FILEDOOR  is set to  a path (a  filename
  799.    and  the  full  path  (drive  and directory) supplied), FileDoor <tm>
  800.    will search for that file;
  801.  
  802.  - If  neither -C  nor an  environment variable  is found, FileDoor <tm>
  803.    will search in the following order:
  804.  
  805.    - The current directory;
  806.  
  807.    - The DOS-path (DOS 2.xx and higher);
  808.  
  809.    - The directory containing FILEDOOR.EXE (FILE_OVR.EXE) (DOS 3.xx  and
  810.      higher);
  811.  
  812.  If no CFG-file is found, FileDoor <tm> will terminate abnormally !
  813.  
  814.  
  815.  For  multi-line  operations  it  is  advised  to use a FileDoor.CFG for
  816.  every line you run or to use the special syntax described below.
  817.  
  818.  FILEDOOR.CFG  contains  many  options.  Some  of them optional, some of
  819.  them not. The general format for the FILEDOOR.CFG file is:
  820.  
  821.  Option {line-tag} {parameter} {parameter} ..... {parameter}
  822.  
  823.  There are NO  restrictions to the  position you start  the command, nor
  824.  the starting position  of the (optional)  parameters, but the  'option'
  825.  and (if  present) the  'parameters' have  to be  separated with  one or
  826.  more spaces. You  can make any  mixture of upper  and lower case  ! The
  827.  {line-tag} MUST start on position 1 of each record !
  828.  
  829.  You  can  insert  comment-lines  into  your FileDoor.CFG by putting the
  830.  %-character on position 1 of the desired line(s). Also empty lines  are
  831.  considered as comment. It won't  take that much longer for  FileDoor to
  832.  start when  there are  many comment-lines.  The logic  of FileDoor will
  833.  handle these lines with great speed.
  834.  
  835.  Some of the parameters in  the FILEDOOR.CFG file can be  overruled with
  836.  command-line  switches.  A  generalized  example  of  FILEDOOR.CFG   is
  837.  included  in  the  release-file.  It  contains ALL options available in
  838.  this release and is called  FILEDOOR.CFG  (FILEDOOR.MUL  also  contains
  839.  examples for fixed and locked modem, as well as an example  of  how  to
  840.  use the {line-tag} options).
  841.  
  842.  The following sub-chapters of  3.3 will contain the  several statements
  843.  you can use in FILEDOOR.CFG.  In the documentation, the statements  are
  844.  put in logical  groups. These groups  contain statements with  the same
  845.  sort of functions. The actual  order of the statements in  FILEDOOR.CFG
  846.  does not matter at all.
  847.  
  848.  In the next pages, I use the following syntax:
  849.  
  850.  [value]      : All  parameters between  '[' and ']'  are  mandatory. If
  851.                 'value' is in lower-case,  it is a mnemonic.  The actual
  852.                 value is described in the documentation;
  853.  
  854.  [VALUE]      : Same as above but when 'VALUE' is in upper-case it is  a
  855.                 real value  and should  be coded  as described  (without
  856.                 the '[' and ']' characters);
  857.  
  858.  {value}      : All parameters between  '{' and '}'  are optional.    If
  859.                 'value' is in lower-case,  it is a mnemonic.  The actual
  860.                 value is described in the documentation;
  861.  
  862.  {VALUE}      : Same as above but when 'VALUE' is in upper-case it is  a
  863.                 real value  and should  be coded  as described  (without
  864.                 the '{' and '}' characters);
  865.  
  866.  
  867.  
  868.  3.3.1 The line-tags
  869.  ───────────────────────────────────────────────────────────────────────
  870.  In a  multi-line environment  you can  choose to  use one  FileDoor.CFG
  871.  file for  each line  (e.g. FILEDOOR.CF1  for line  1, FILEDOOR.CF2  for
  872.  line 2 and  so on) or  you can create  one FILEDOOR.CFG which  includes
  873.  all the options for ALL lines.  In the last case, you MUST  include the
  874.  -N command-line option in the menu-call for FileDoor <tm>. All  options
  875.  that are common for all lines  can be coded as normal options.  Options
  876.  for a  specific line  (like the  place and  name of  the log-files, the
  877.  several directories, the modem/protocol  options for locked and  normal
  878.  modems) can be supplied for all different lines. In that case you  must
  879.  prefix the option with a so called line-tag. The general idea can  best
  880.  be explained with an example (a little part of a FILEDOOR.CFG file):
  881.  
  882.  [1] System           RA1  D:\BBS\RA\FILES.RA
  883.  [2] System           RA1  D:\BBS\RA\RA2\FILES.RA
  884.  FileDoorDir        D:\BBS\RA\TXTFILES\
  885.  [1] LogFile              D:\BBS\RA\LINE01.LOG
  886.  [2] LogFile              D:\BBS\RA\RA2\LINE02.LOG
  887.  Protocol 94    Z      U   100  0 ZModem
  888.  Usage 0 0 N Y
  889.  [1] DSZ D:\BBS\PRO\DSZ.COM port $1 ha on rz -Z -m           $M
  890.  [2] DSZ D:\BBS\PRO\DSZ.COM port $1 rz -Z -m                 $M
  891.  Protocol 94    Z      D   100  0 ZModem
  892.  Usage 0 0 N Y
  893.  [1] DSZ D:\BBS\PRO\DSZ.COM port $1 ha on sz -Z -k -m $3     $M
  894.  [2] DSZ D:\BBS\PRO\DSZ.COM port $1 sz -Z -k -m $3           $M
  895.  
  896.  In the previous  example you can  see the line-tags  ([1] and [2])  for
  897.  some of the  options. When an  option does NOT  contain a line-tag,  it
  898.  will be used for  all lines, when an  option is prefixed by  a line-tag
  899.  (like [1] for  line 1 and  [2] for line  2) it will  only be active for
  900.  the  give  line).  With  this  mechanism  of line-tags, you can use one
  901.  FileDoor.CFG for up to 8 lines !
  902.  
  903.  
  904.  3.3.2 Very special statements.
  905.  ───────────────────────────────────────────────────────────────────────
  906.  The following statement(s) are very special and should only be used  in
  907.  very special cases.
  908.  
  909.  ┌─────────────────────────────────────────────────────────────────────┐
  910.  │ Debug [path]                                                        │
  911.  └─────────────────────────────────────────────────────────────────────┘
  912.  Usage   : I have  learned from earlier  versions that one  of the  most
  913.            difficult  problems  is  to  find  a  specific error. This is
  914.            because an unknown number of unknown programs (protocols  and
  915.            exits) can make  use of FileDoor  and the basic  level of the
  916.            common user can vary from poor to very good.
  917.  
  918.            If you  ever have  a strange  problem and  the error does not
  919.            look  obvious,  you  could  consider  to  set this option on.
  920.  
  921.            [path] must be a drive (optional), directory and filename  of
  922.                   the debug-file to be written. Remember that this  file
  923.                   will  NOT  be  serialized  (shared)  so you must use a
  924.                   different file for  each different BBS-line  (when you
  925.                   run a multi-line BBS);
  926.  
  927.            Inside the log  you can find  references to names  and values
  928.            that will not have much  meaning to you, but most  important,
  929.            you  can   also  find   the  Bimodem-alike,   DSZ-alike   and
  930.            OPUS-alike  log-records   (that  are   normally  deleted   by
  931.            FileDoor after the download).
  932.  
  933.            When reporting an error, I can  ask you to send me a  part of
  934.            the debug-log,  so be  prepared when  you enter  a problem to
  935.            have a  debug-log ready  or try  to recreate  the error first
  936.            with the debug-log on. You can always consult me first !
  937.  
  938.            Setting Debug to on means that there is a little drawback  in
  939.            speed (but not in file-search). Also there can be some  extra
  940.            disk-access,  so  the  total  loss  in  speed is variable for
  941.            every system.  I would  not advise  to set  Debug to  on as a
  942.            default !
  943.  
  944.  Example : Debug C:\SYS\TMP\XFDDEBUG.L01
  945.            ─────────────────────────────────────────────────────────────
  946.  Means   : FileDoor will write a debug-log to XFDDEBUG.L01 in the
  947.            C:\SYS\TMP directory.
  948.            ─────────────────────────────────────────────────────────────
  949.  
  950.  
  951.  ┌─────────────────────────────────────────────────────────────────────┐
  952.  │ SelMax [maxfiles]                                                   │
  953.  └─────────────────────────────────────────────────────────────────────┘
  954.  Usage   : Normally FileDoor will calculate the maximum number of  files
  955.            that COULD be selected in  one execution of FileDoor (with  a
  956.            maximum of  255). To  preserve memory,  you can  use a  lower
  957.            number though I should urge  you to tell that you  should not
  958.            make it too low.
  959.  
  960.            [maxfiles] must  be  set  to  a  value between 1 and 255.  By
  961.                       default FileDoor will try  to use 255 entries  but
  962.                       will lower the number by itself when there is  not
  963.                       enough memory.
  964.  
  965.            If the  maximum number  of files  to be  selected is reached,
  966.            the user will  get a warning  and the transfer  will start at
  967.            once. So when you  use a value of  1, all protocols can  only
  968.            transfer 1 file at a time !
  969.  
  970.            Each   file-selection   entry   will   need   425   bytes  of
  971.            conventional  memory,  so  reducing  the  value  to  100 will
  972.            reduce the memory requirements with 41.5 Kb.
  973.  
  974.  Example : SelMax 200
  975.            ─────────────────────────────────────────────────────────────
  976.  Means   : FileDoor will try to allocate 200 entries (55 less than the
  977.            normal value) for file-selection.
  978.            ─────────────────────────────────────────────────────────────
  979.  
  980.  
  981.  ┌─────────────────────────────────────────────────────────────────────┐
  982.  │ NoOwnDSZLog                                                         │
  983.  └─────────────────────────────────────────────────────────────────────┘
  984.  Usage   : Normally  FileDoor sets  the DSZLOG  environment variable  by
  985.            itself.  This is needed  because FileDoor wants to make  sure
  986.            that it can examine this log-file.
  987.  
  988.            To  do  so,  FileDoor  will  alter  the  environment variable
  989.            DSZLOG   itself,   using   some   special   tricks.  Not  ALL
  990.            DOS-versions  allow  such  tricks  (AT&T/Olivetti  to  name a
  991.            few). In these  cases you should  set the DSZLOG  environment
  992.            variable yourself and add this option in FILEDOOR.CFG.
  993.  
  994.  Example : NoOwnDSZLOG
  995.            ─────────────────────────────────────────────────────────────
  996.  Means   : See description
  997.            ─────────────────────────────────────────────────────────────
  998.  
  999.  
  1000.  3.3.3 Basic Parameters
  1001.  ───────────────────────────────────────────────────────────────────────
  1002.  The following statements are more or less basic statements.
  1003.  
  1004.  ┌─────────────────────────────────────────────────────────────────────┐
  1005.  │ BBSLine [line]                                                      │
  1006.  └─────────────────────────────────────────────────────────────────────┘
  1007.  Usage   : As said before, in multi-line operations, FileDoor must  know
  1008.            the line it is running on. By default, FileDoor uses line  1,
  1009.            so when you run one  single line, both -N and/or  this option
  1010.            can  be  omitted.   There  are  some  reasons to put the line
  1011.            inside FileDoor.CFG when you run multiple lines:
  1012.  
  1013.            - There  is a   flaw in  Remote Access   with the  *N  option
  1014.              that makes   the   system   of   generic   menu's   for all
  1015.              lines very difficult to   use with  FileDoor (see   chapter
  1016.              on multi line operations);
  1017.  
  1018.            - Your command-line is getting to long;
  1019.  
  1020.            - You can see the which line-number belongs to this CFG file;
  1021.  
  1022.            [line] must  be the  BBS-line-number and  can be  set in  the
  1023.                   range from 1 to 99.
  1024.  
  1025.  Example : BBSLine 3
  1026.            ─────────────────────────────────────────────────────────────
  1027.  Means   : This configuration file is setup for the 3rd BBS-line and all
  1028.            temporary files will carry this identification.
  1029.            ─────────────────────────────────────────────────────────────
  1030.  
  1031.  
  1032.  ┌─────────────────────────────────────────────────────────────────────┐
  1033.  │ System [system] [path]                                              │
  1034.  └─────────────────────────────────────────────────────────────────────┘
  1035.  Usage   : This defines the BBS-system that you use and the path to the
  1036.            file that contains the file-area information.
  1037.  
  1038.            [system] must be set to the  type of system that you use  and
  1039.                     can have the following values:
  1040.  
  1041.                     - RA0  for Remote Access versions up to 0.04, using
  1042.                            the file FILES.RA (0.04 format);
  1043.                     - RA1  for Remote Access versions 1.0x, using the
  1044.                            file FILES.RA (1.0x format);
  1045.                     - RA11 for Remote Access versions 1.1x, using the
  1046.                            file FILES.RA (1.1x format);
  1047.                     - QBBS for QuickBBS 0.xx to 2.74, using the file
  1048.                            FLSEARCH.CTL;
  1049.                     - QNEW for QuickBBS 2.75 and up, using the file
  1050.                            FILECFG.DAT;
  1051.                     - SBBS for SuperBBS 1.1x and up, using the file
  1052.                            FLSEARCH.CTL;
  1053.  
  1054.            [path]   Must point  to the  complete drive,  directory   and
  1055.                     filename of the file-area file (see names above)  of
  1056.                     the BBS (for this BBS-line);
  1057.  
  1058.            If you  have the  idea that  the internal  format of the area
  1059.            file  has  been  changed  (due  to  a  change  of BBS release
  1060.            number) you are invited to  contact the author, so I  can add
  1061.            the newer format ASAP;
  1062.  
  1063.  Example : System  RA11  D:\BBS\RA\FILES.RA
  1064.            ─────────────────────────────────────────────────────────────
  1065.  Means   : You are using a Remote Access <tm> 1.11 (or higher) version
  1066.            and the area-file for this BBS-line is in D:\BBS\RA and has
  1067.            the name FILES.RA;
  1068.            ─────────────────────────────────────────────────────────────
  1069.  
  1070.  
  1071.  ┌─────────────────────────────────────────────────────────────────────┐
  1072.  │ NoAutoUpdate [directory]                                            │
  1073.  └─────────────────────────────────────────────────────────────────────┘
  1074.  Usage   : Some  of   the  supported  BBS  programs   can  reload    the
  1075.            information from  EXITINFO.BBS. At  this moment  the RA  0.04
  1076.            and higher, the  SBBS (with *E  used) and QuickBBS  2.75 (and
  1077.            higher) can do so and the older QuickBBS releases can not.
  1078.  
  1079.            If your BBS does not  support the reload of information  from
  1080.            EXITINFO.BBS or you dislike the direct updates that  FileDoor
  1081.            will perform when the BBS is  able to do so, you can  set the
  1082.            NoAutoUpdate  option.  In  this  case  FileDoor will create a
  1083.            file called  FileDoor.UPD in  the CURRENT  directory and will
  1084.            use that file for the user-credits (see chapter on FD_UPD).
  1085.  
  1086.            [directory] must  point  to  the  valid  directory that  will
  1087.                        contain FILEDOOR.UPD.  All lines  (if multi-line)
  1088.                        must access the SAME FILEDOOR.UPD otherwise  your
  1089.                        users  can  swap  lines  and  download as many as
  1090.                        [lines] times the number of files as allowed.
  1091.  
  1092.            NoAutoUpdate is NOT needed for the current (newest)  versions
  1093.            of the supported BBS-programs.
  1094.  
  1095.  Example : NoAutoUpdate D:\BBS\RA
  1096.            ─────────────────────────────────────────────────────────────
  1097.  Means   : FileDoor will not update the EXITINFO.BBS (alike) file for
  1098.            this type of BBS but will create a FILEDOOR.UPD file in the
  1099.            directory D:\BBS\RA.
  1100.            ─────────────────────────────────────────────────────────────
  1101.  
  1102.  
  1103.  
  1104.  3.3.4 Paths
  1105.  ───────────────────────────────────────────────────────────────────────
  1106.  The following options will describe the access that FileDoor has to  do
  1107.  on several directories and files.
  1108.  
  1109.  ┌─────────────────────────────────────────────────────────────────────┐
  1110.  │ FileDoorDir [dir]                                                   │
  1111.  └─────────────────────────────────────────────────────────────────────┘
  1112.  Usage   : If set, FileDoor will search for it's menu and help  files in
  1113.            the supplied path. If not set, FileDoor will create the  menu
  1114.            by its own. Help-files and menu-files must all be put  inside
  1115.            this directory when used. By DEFAULT they must have  specific
  1116.            names but  you CAN  overrule them  with a  name you choose by
  1117.            yourself (see the AnsAsc option).
  1118.  
  1119.            [dir] This value  must point to  the directory that  contains
  1120.                  all the menu-files  (optional) and/or help-files  (also
  1121.                  optional). If specific files are not available in  this
  1122.                  directory, FileDoor  will give  an internal  message or
  1123.                  will build menus by itself;
  1124.  
  1125.            Examples  of  these  files  are  available inside the release
  1126.            archive. Be  sure to  update at  LEAST the  menu-files to the
  1127.            protocols you use on your own system !
  1128.  
  1129.  Example : FileDoorDir D:\BBS\RA\TXTFILES
  1130.            ─────────────────────────────────────────────────────────────
  1131.  Means   : Menu/Help files (which are in use) can be found in the
  1132.            directory D:\BBS\RA\TXTFILES.
  1133.            ─────────────────────────────────────────────────────────────
  1134.  
  1135.  
  1136.  ┌─────────────────────────────────────────────────────────────────────┐
  1137.  │ UploadPath [dir]                                                    │
  1138.  └─────────────────────────────────────────────────────────────────────┘
  1139.  Usage   : If set, FileDoor will use this directory for uploaded  files.
  1140.            This directory is overruled  by the -U[path] on  the command-
  1141.            line that is  used to call  FileDoor (if available).  If this
  1142.            is the case,  FileDoor will not  check the UploadPath  option
  1143.            for valid data.
  1144.  
  1145.            [dir] must point to a valid (available) directory;
  1146.  
  1147.  Example : UploadPath D:\BBS\RA\FILES\UPLOADS
  1148.            ─────────────────────────────────────────────────────────────
  1149.  Means   : The uploads (normal and/or private) will be put in the
  1150.            directory D:\BBS\RA\FILES\UPLOADS.
  1151.            ─────────────────────────────────────────────────────────────
  1152.  
  1153.  
  1154.  ┌─────────────────────────────────────────────────────────────────────┐
  1155.  │ PUploadPath [dir]                                                   │
  1156.  └─────────────────────────────────────────────────────────────────────┘
  1157.  Usage   : If set,  FileDoor will use this directory for  uploaded files
  1158.            which are marked private (description starts  with /) to  the
  1159.            Sysop. If this  option (or -P  on the call)  is NOT available
  1160.            but private  uploads are  allowed, FileDoor  will move  these
  1161.            uploads to  the normal  upload-directory.   This directory is
  1162.            overruled by the -P[path] on  the command- line that is  used
  1163.            to  call  filedoor  (if  available).  If  this  is  the case,
  1164.            FileDoor  will  not  check  the  PUploadPath option for valid
  1165.            data.
  1166.  
  1167.            [dir] must point to a valid (available) directory;
  1168.  
  1169.  Example : PUploadPath D:\BBS\RA\FILES\PRIVATE
  1170.            ─────────────────────────────────────────────────────────────
  1171.  Means   : The uploads (only private) will be put in the directory
  1172.            D:\BBS\RA\FILES\PRIVATE.
  1173.            ─────────────────────────────────────────────────────────────
  1174.  
  1175.  
  1176.  ┌─────────────────────────────────────────────────────────────────────┐
  1177.  │ DupePath [dir]                                                      │
  1178.  └─────────────────────────────────────────────────────────────────────┘
  1179.  Usage   : If set,  FileDoor will move  ANY file, marked  as a dupe,  to
  1180.            this directory. Normally FileDoor will delete the dupe  file.
  1181.            Even if  you use  this option,  FileDoor will  NOT count  the
  1182.            dupe but you can  still have a peek  at it, because it is not
  1183.            deleted.
  1184.  
  1185.            [dir] must point to a valid (available) directory;
  1186.  
  1187.  Example : DupePath D:\BBS\RA\FILES\DUPES
  1188.            ─────────────────────────────────────────────────────────────
  1189.  Means   : Duplicate uploads are not deleted but moved to the directory
  1190.            D:\BBS\RA\FILES\DUPES. They are NOT counted !
  1191.            ─────────────────────────────────────────────────────────────
  1192.  
  1193.  
  1194.  ┌─────────────────────────────────────────────────────────────────────┐
  1195.  │ LogFile [path]                                                      │
  1196.  └─────────────────────────────────────────────────────────────────────┘
  1197.  Usage   : Choose the logfile for logging all Filedoor activities.   The
  1198.            format  of  the  log-file  is  free  and MUST be set with the
  1199.            special log-file  options (see  later on).  This allows  both
  1200.            standard  logging  (designed  to  the  same format as the log
  1201.            that  the  BBS  program   makes)  and  non-standard   logging
  1202.            (something YOU  like). The  older 2.xx  versions of  FileDoor
  1203.            needed a parameter to set the type of log !
  1204.  
  1205.            [path] must point to  a drive (optional), directory  and name
  1206.                   of the log-file for this line.
  1207.  
  1208.            Please remember  to point   to VARIOUS  log-files for    each
  1209.            line you run,  unless you want  trash in you  log or on  your
  1210.            disk.
  1211.  
  1212.  Example : LogFile D:\LOG\RALIN01.LOG
  1213.            ─────────────────────────────────────────────────────────────
  1214.  Means   : The log-file for this BBS-line is called RALINE01.LOG and
  1215.            will be written (created) in D:\LOG.
  1216.            ─────────────────────────────────────────────────────────────
  1217.  
  1218.  
  1219.  ┌─────────────────────────────────────────────────────────────────────┐
  1220.  │ UploadLog [dir]                                                     │
  1221.  │ UploadLog [path]                                                    │
  1222.  └─────────────────────────────────────────────────────────────────────┘
  1223.  Usage   : Sets a special logfile for all uploads including the name  of
  1224.            the uploader.  Either use  a directory  or a  fully specified
  1225.            filename including a path.
  1226.  
  1227.            [dir]  in this form,  FileDoor will create a log-file  in the
  1228.                   supplied directory under the name FDUPLOAD.LOG;
  1229.  
  1230.            [path] in  this  form,  you  must  supply  the  name  of  the
  1231.                   log-file, the directory and (optionally) the drive  to
  1232.                   use;
  1233.  
  1234.            Please remember to point to various log-files for each  line,
  1235.            unless you want trash in you log-file or on your disk.
  1236.  
  1237.  Example : UploadLog D:\LOG\UPLOAD02.LOG
  1238.            ─────────────────────────────────────────────────────────────
  1239.  Means   : Create a log-file for uploads under the name UPLOAD02.LOG in
  1240.            directory D:\LOG.
  1241.            ─────────────────────────────────────────────────────────────
  1242.  
  1243.  
  1244.  ┌─────────────────────────────────────────────────────────────────────┐
  1245.  │ PVTUploadLog [dir]                                                  │
  1246.  │ PVTUploadLog [path]                                                 │
  1247.  └─────────────────────────────────────────────────────────────────────┘
  1248.  Usage   : Sets  a logfile  for PRIVATE  uploads including  the name  of
  1249.            the  uploader.   Either  use    a  directory   or  a    fully
  1250.            specified filename including a path.
  1251.  
  1252.            [dir]  in this form,  FileDoor will create a log-file  in the
  1253.                   supplied directory under the name PVTUPLOA.LOG;
  1254.  
  1255.            [path] in  this  form,  you  must  supply  the  name  of  the
  1256.                   log-file, the directory and (optionally) the drive  to
  1257.                   use;
  1258.  
  1259.            Please remember to point to various log-files for each  line,
  1260.            unless you want trash in  you log-file or on your  disk. This
  1261.            log-file can be written to the same files as assigned to  the
  1262.            UploadLog option.
  1263.  
  1264.  Example : PVTUploadLog D:\LOG\PULOAD02.LOG
  1265.            ─────────────────────────────────────────────────────────────
  1266.  Means   : Create a PRIVATE-log (uploads) under the name PULOAD02.LOG in
  1267.            directory D:\LOG.
  1268.            ─────────────────────────────────────────────────────────────
  1269.  
  1270.  
  1271.  ┌─────────────────────────────────────────────────────────────────────┐
  1272.  │ DownloadLog [dir]                                                   │
  1273.  │ DownloadLog [path]                                                  │
  1274.  └─────────────────────────────────────────────────────────────────────┘
  1275.  Usage   : Sets a  special logfile for all downloads including  the name
  1276.            of the  user. Either  use a  directory or  a fully  specified
  1277.            filename including a path.
  1278.  
  1279.            [dir]  in this form,  FileDoor will create a log-file  in the
  1280.                   supplied directory under the name FDDNLOAD.LOG;
  1281.  
  1282.            [path] in  this  form,  you  must  supply  the  name  of  the
  1283.                   log-file, the directory and (optionally) the drive  to
  1284.                   use;
  1285.  
  1286.            Please remember to point to various log-files for each  line,
  1287.            unless you want trash in  you log-file or on your  disk. This
  1288.            log-file  can  be  the  same  as  assigned  in  various other
  1289.            options.
  1290.  
  1291.  Example : DownloadLog D:\LOG\DNLOAD02.LOG
  1292.            ─────────────────────────────────────────────────────────────
  1293.  Means   : Create a log-file for downloads under  the  name DNLOAD02.LOG
  1294.            in directory D:\LOG.
  1295.            ─────────────────────────────────────────────────────────────
  1296.  
  1297.  
  1298.  ┌─────────────────────────────────────────────────────────────────────┐
  1299.  │ SwapPath  [dir]                                                     │
  1300.  └─────────────────────────────────────────────────────────────────────┘
  1301.  Usage   : Sets the directory where FileDoor will place any  swap-files.
  1302.            Only the  directory is  allowed. FileDoor  will generate  any
  1303.            filename by  itself, based  on the  BBS-line and  the type of
  1304.            swap. Remember that there must  be at least 200K free  on the
  1305.            disk you point to for every copy of FileDoor that is  swapped
  1306.            (see chapter on swapping).
  1307.  
  1308.            [dir] must point to a valid (available) directory;
  1309.  
  1310.  Example : SwapPath E:\ZIP
  1311.            ─────────────────────────────────────────────────────────────
  1312.  Means   : FileDoor will create a swap-file (if needed) in the directory
  1313.            E:\ZIP.
  1314.            ─────────────────────────────────────────────────────────────
  1315.  
  1316.  
  1317.  ┌─────────────────────────────────────────────────────────────────────┐
  1318.  │ TempPath [dir]                                                      │
  1319.  └─────────────────────────────────────────────────────────────────────┘
  1320.  Usage   : Set the path where FileDoor will place uploads and  temporary
  1321.            files while work  is in progress.  FileDoor will put  uploads
  1322.            in  a  temporary  directory  first.  Also  some  small files,
  1323.            depending on the protocol, are placed inside this  directory.
  1324.            You can  assign a  directory on  the same  drive as where the
  1325.            uploads  will   be  put,   because  FileDoor   will  use   an
  1326.            intelligent  move  (move  without  data  transport)  when the
  1327.            temporary-  and  upload  directory  are  on  the  same drive.
  1328.            FileDoor will always create a directory UNDER this  directory
  1329.            to use as the temporary directory and will generate the  name
  1330.            by itself (depending on  date/time and BBS line).  Best thing
  1331.            you can do is to let this option point to the same  directory
  1332.            as  the  up-  load   directory.  FileDoor  will  remove   the
  1333.            directories that are created UNDER this directory;
  1334.  
  1335.            [dir] must point to a valid (available) directory;
  1336.  
  1337.  Example : TempPath D:\BBS\RA\FILES\UPLOADS
  1338.            ─────────────────────────────────────────────────────────────
  1339.  Means   : FileDoor will create temporary (upload) directories under the
  1340.            directory D:\BBS\RA\FILES\UPLOADS
  1341.            ─────────────────────────────────────────────────────────────
  1342.  
  1343.  
  1344.  ┌─────────────────────────────────────────────────────────────────────┐
  1345.  │ BimodemCfg [path]                                                   │
  1346.  └─────────────────────────────────────────────────────────────────────┘
  1347.  Usage   : Set   the  path  to   the BiModem.Cfg (Bimodem  configuration
  1348.            file).  You MUST use this option when you include Bimodem  in
  1349.            the protocols. It must point to the name and location of  the
  1350.            Bimodem.CFG that is used for this (or all) line(s).  FileDoor
  1351.            will use this file as a template for a temporary copy of  the
  1352.            Bimodem.Cfg. Various things (like com-port) are overruled  by
  1353.            FileDoor, so you can use one single (template) Bimodem.CFG.
  1354.  
  1355.            [path] must point to the drive, directory AND name of the
  1356.                   template BIMODEM.CFG
  1357.  
  1358.  Example : BimodemCfg D:\BBS\PROTOCOL\BIMODEM.CFG
  1359.            ─────────────────────────────────────────────────────────────
  1360.  Means   : FileDoor will use the BIMODEM.CFG file in D:\BBS\PROTOCOL as
  1361.            the template for Bimodem transfers.
  1362.            ─────────────────────────────────────────────────────────────
  1363.  
  1364.  
  1365.  ┌─────────────────────────────────────────────────────────────────────┐
  1366.  │ Verify                                                              │
  1367.  └─────────────────────────────────────────────────────────────────────┘
  1368.  Usage   : When  you use  Bimodem as  one of  the protocols (you  should
  1369.            include the  previous option),  you can  either set Bimodem's
  1370.            file-verify off or on (by including this option).
  1371.  
  1372.  Example : Verify
  1373.            ─────────────────────────────────────────────────────────────
  1374.  Means   : See description
  1375.            ─────────────────────────────────────────────────────────────
  1376.  
  1377.  
  1378.  ┌─────────────────────────────────────────────────────────────────────┐
  1379.  │ AlternateFilesPath [dir]                                            │
  1380.  └─────────────────────────────────────────────────────────────────────┘
  1381.  Usage   : When running  with Remote Access  1.xx (or higher),  you  can
  1382.            have CD-ROM files with  separate FILES.xx files. In  RACONFIG
  1383.            there is  an option  that will  point to  the directory  that
  1384.            contains these  copies of  FILES.xx. Set  this option  to the
  1385.            same directory.
  1386.  
  1387.            [dir] must point to a valid (available) directory;
  1388.  
  1389.  Example : AlternateFilesPath D:\BBS\RA\ROMFILES
  1390.            ─────────────────────────────────────────────────────────────
  1391.  Means   : FileDoor will search for the FILES.xx files in the directory
  1392.            D:\BBS\RA\ROMFILES
  1393.            ─────────────────────────────────────────────────────────────
  1394.  
  1395.  
  1396.  ┌─────────────────────────────────────────────────────────────────────┐
  1397.  │ BADFILESName [dir]                                                  │
  1398.  │ BADFILESName [path]                                                 │
  1399.  └─────────────────────────────────────────────────────────────────────┘
  1400.  Usage   : When   your  BBS  uses   the BADFILES.CTL file (see your  BBS
  1401.            documentation), you can use this file as input for FileDoor.
  1402.  
  1403.            [dir]  In this form  you only supply the directory  where the
  1404.                   BADFILES.CTL  is  located.  FileDoor  will  append the
  1405.                   name BADFILES.CTL behind the directory you supply;
  1406.  
  1407.            [path] In  this  form  you  supply  the full path (so  drive,
  1408.                   directory AND  name) for  the BADFILES.CTL  file. This
  1409.                   can be used in case you use a different name for  this
  1410.                   file;
  1411.  
  1412.            The different  file-masks from  BADFILES.CTL are  merged with
  1413.            the  Unwanted  options  in  the  FILEDOOR.CFG file. Duplicate
  1414.            file-masks will  be ignored  and only  stored in  memory just
  1415.            once.
  1416.  
  1417.  Example : BADFILESName D:\BBS\RA
  1418.            ─────────────────────────────────────────────────────────────
  1419.  Means   : You will use a BADFILES.CTL file that is located in D:\BBS\RA
  1420.            and has the name BADFILES.CTL.
  1421.            ─────────────────────────────────────────────────────────────
  1422.  
  1423.  
  1424.  ┌─────────────────────────────────────────────────────────────────────┐
  1425.  │ FILESCTLName [dire]                                                 │
  1426.  │ FILESCTLName [path]                                                 │
  1427.  └─────────────────────────────────────────────────────────────────────┘
  1428.  Usage   : When   your  BBS  uses   the  FILES.CTL  file   (see your BBS
  1429.            documentation), you can use this file as input for  FileDoor.
  1430.            With this  option you  point to  the correct  FILES.CTL file.
  1431.            In this  case the  FILESCTLName option  must either  point to
  1432.            the  directory  containing  FILES.CTL  or  it must point to a
  1433.            full filename (path, with  drive and directory) that  has the
  1434.            same syntax as the FILES.CTL.
  1435.  
  1436.            [dir]    In this form  you only supply  the directory   where
  1437.                     the FILES.CTL is  located. FileDoor will  append the
  1438.                     name FILES.CTL behind the directory you supply;
  1439.  
  1440.            [path]   In this form  you supply the  full path (so   drive,
  1441.                     directory  AND  name)  for  the FILES.CTL file. This
  1442.                     can be  used in  case you  use a  different name for
  1443.                     this file;
  1444.  
  1445.            {NOTIME} The NOTIME parameter  is optional and when  supplied
  1446.                     will tell FileDoor that ALL file(s) that are  marked
  1447.                     as FREE-files (inside  the FILES.CTL, with  /FREE as
  1448.                     used  parameter),  can  be  downloaded for free EVEN
  1449.                     when there is not enough time left.
  1450.  
  1451.            The different  options from  FILES.CTL (free  files, password
  1452.            protected  files  and  unwanted  files)  are  merged with the
  1453.            FreeFile,  PasswordProtect  and   Unwanted  options  in   the
  1454.            FILEDOOR.CFG file. Duplicate  file-masks will be  ignored and
  1455.            only stored in memory just once.
  1456.  
  1457.  Example : FILESCTLName D:\BBS\RA NOTIME
  1458.            ─────────────────────────────────────────────────────────────
  1459.  Means   : You will use a FILES.CTL file that is located in D:\BBS\RA
  1460.            and has the name FILES.CTL. All files marked as free (/FREE)
  1461.            inside FILES.CTL can be downloaded even when there isn't
  1462.            enough time.
  1463.            ─────────────────────────────────────────────────────────────
  1464.  
  1465.  
  1466.  ┌─────────────────────────────────────────────────────────────────────┐
  1467.  │ LIVESYSTEMSPath [dir]                                               │
  1468.  └─────────────────────────────────────────────────────────────────────┘
  1469.  Usage   : When  you use  the program  USERON by  LiveSystems, you   can
  1470.            include this option. It must  point to the same directory  as
  1471.            pointed  by  USERON.  In  this  case,  FileDoor  will  create
  1472.            entries  that  can  be  read  by  USERON.EXE  and that can be
  1473.            displayed  on  the  BBS.  Users  on  other  lines can see the
  1474.            progress  inside  FileDoor.  You  should check the USERON.EXE
  1475.            program ! It is a nice enhancement to your BBS.
  1476.  
  1477.            Normally you must point to the so called  'semaphore path' as
  1478.            supplied in the configuration of Remote Access <tm> (1.1x).
  1479.  
  1480.  Example : LIVESYSTEMSPath D:\BBS\RA
  1481.            ─────────────────────────────────────────────────────────────
  1482.  Means   : FileDoor will write semaphore files for USERON.EXE in the
  1483.            directory D:\BBS\RA. USERON.EXE must point to the same
  1484.            location.
  1485.            ─────────────────────────────────────────────────────────────
  1486.  
  1487.  
  1488.  ┌─────────────────────────────────────────────────────────────────────┐
  1489.  │ USERONPath [dir]                                                    │
  1490.  │ USERONPath [path]                                                   │
  1491.  └─────────────────────────────────────────────────────────────────────┘
  1492.  Usage   : When  you use  Remote Access  <tm> as  the BBS,  you can  let
  1493.            FileDoor update the USERON.BBS  file. In this case  the other
  1494.            users (other lines) can see that someone is doing a  download
  1495.            or an upload. Normally,  FileDoor will use the  normal system
  1496.            directory but in certain cases  it can be needed to  use this
  1497.            option to point to that directory or even the full filename.
  1498.  
  1499.            [dir]    In this form  you only supply  the directory   where
  1500.                     the USERON.BBS is located. FileDoor will append  the
  1501.                     name USERON.BBS behind the directory you supply;
  1502.  
  1503.            [path]   In this form  you supply the  full path (so   drive,
  1504.                     directory AND  name) for  the USERON.BBS  file. This
  1505.                     can be  used in  case you  use a  different name for
  1506.                     this file;
  1507.  
  1508.            The  USERON  mechanism  of  Remote  Access is only capable of
  1509.            showing the  type of  action (Upload,  Download) but  not the
  1510.            progress  inside  FileDoor.  Take  a  look at the LiveSystems
  1511.            USERON.EXE program if this is what you like !
  1512.  
  1513.  Example : USERONPath D:\BBS\RA
  1514.            ─────────────────────────────────────────────────────────────
  1515.  Means   : FileDoor will write semaphores inside the USERON.BBS file in
  1516.            directory D:\BBS\RA.
  1517.            ─────────────────────────────────────────────────────────────
  1518.  
  1519.  
  1520.  ┌─────────────────────────────────────────────────────────────────────┐
  1521.  │ USERPath [dir]                                                      │
  1522.  └─────────────────────────────────────────────────────────────────────┘
  1523.  Usage   : FileDoor 3.xx  makes it possible  to set aside  some  special
  1524.            files  for  a  certain  user.  In  this case you must use the
  1525.            FileUSER and FileMAIN programs to do so. These programs  will
  1526.            place the  files in  a special  directory under  a predefined
  1527.            directory.  With   the  USERPath   option  you   assign  this
  1528.            directory  which  will  be  used  as  the  base for all other
  1529.            (temporary)  directories  that  are  created by FILEUSER.EXE.
  1530.            Even if  you do  not plan  to use  the FILEUSER  program, you
  1531.            should set this directory to a location where you  (normally)
  1532.            have some space left.  Future versions of FileDoor  will make
  1533.            special usage of this directory !
  1534.  
  1535.            [dir] must point to a valid (available) directory;
  1536.  
  1537.  Example : USERPath D:\BBS\RA\USERFILE
  1538.            ─────────────────────────────────────────────────────────────
  1539.  Means   : FileDoor will look for special directories under the supplied
  1540.            directory D:\BBS\RA\USERFILE. The FileUSER and FileMAIN
  1541.            programs will also use this option !
  1542.            ─────────────────────────────────────────────────────────────
  1543.  
  1544.  
  1545.  ┌─────────────────────────────────────────────────────────────────────┐
  1546.  │ ExternalChat [program] {options}                                    │
  1547.  └─────────────────────────────────────────────────────────────────────┘
  1548.  Usage   : When you include this  option, it will be  possible to  press
  1549.            ALT-C inside FileDoor to  start a chat-program. In  this case
  1550.            the user-time will  NOT stop (that  will be fixed  in a later
  1551.            version) but you will be able to start a quick chat with  the
  1552.            user.
  1553.  
  1554.            [program] must be the  full name (drive, directory  and file)
  1555.                      of the external chat program;
  1556.  
  1557.            {options} can be one or more options to pass to the  external
  1558.                      chat program.  Like most  of the  programs that can
  1559.                      be  called  from  within  FileDoor, you can include
  1560.                      macros that will be replaced by actual values  when
  1561.                      the program is called. These are:
  1562.  
  1563.                      $C : Will be replaced by the COM-port number
  1564.                      $B : Will be replaced by the BAUD-rate
  1565.                      $T : Will be replaced by the time that is left
  1566.                           for the users session;
  1567.                      $L : Will be replaced by the BBS-line-number
  1568.                      $M : Swap FileDoor from memory before the call
  1569.                      $! : Will force FileDoor to stop the time counting
  1570.  
  1571.  Example : ExternalChat C:\RA\UTILS\DISPCHAT.EXE /COM$C /QUICK /MULTI
  1572.            ─────────────────────────────────────────────────────────────
  1573.  Means   : FileDoor can call the external chat program DISPCHAT.EXE when
  1574.            ALT-C is pressed. Some macros will be expanded and passed to
  1575.            DISPCHAT.EXE.
  1576.            ─────────────────────────────────────────────────────────────
  1577.  
  1578.  
  1579.  ┌─────────────────────────────────────────────────────────────────────┐
  1580.  │ ExternalView [program] {options}                                    │
  1581.  └─────────────────────────────────────────────────────────────────────┘
  1582.  Usage   : When the user is selecting files, she/he will get the  option
  1583.            to view  files. FileDoor's  internal view  is limited  to the
  1584.            display  of  filenames  inside  archives  but  you can add an
  1585.            external view program like DISP's MTS.EXE to view inside  the
  1586.            files as well. If  you would like to  do so, you need  to add
  1587.            this option to FILEDOOR.CFG.
  1588.  
  1589.            [program] must be the  full name (drive, directory  and file)
  1590.                      of the external view program;
  1591.  
  1592.            {options} can be one or more options to pass to the  external
  1593.                      view program.  Like most  of the  programs that can
  1594.                      be  called  from  within  FileDoor, you can include
  1595.                      macros that will be replaced by actual values  when
  1596.                      the program is called. These are:
  1597.  
  1598.                      $C : Will be replaced by the COM-port number
  1599.                      $B : Will be replaced by the BAUD-rate
  1600.                      $T : Will be replaced by the time that is left
  1601.                           for the users session;
  1602.                      $F : Will be replaced with the full path to the
  1603.                           file that must be viewed;
  1604.                      $L : Will be replaced by the BBS-line-number
  1605.                      $M : Swap FileDoor from memory before the call
  1606.  
  1607.            When you want to include  MTS.EXE into this option, you  need
  1608.            at least the  7.59 version (a  pre 8.01 version)  or all 8.0x
  1609.            versions or higher ! Lower versions can not work with  single
  1610.            files, nor can they display non-archived files.
  1611.  
  1612.  Example : ExternalView C:\RA\UTILS\MTS.EXE /L$L /F$F
  1613.            ─────────────────────────────────────────────────────────────
  1614.  Means   : MTS.EXE (in C:\RA\UTILS) is called for viewing files. The $L
  1615.            will be expanded to the BBS-line number and the $F will be
  1616.            expanded to the full path to the file.
  1617.            ─────────────────────────────────────────────────────────────
  1618.  
  1619.  
  1620.  3.3.5 Statements that define the logging format
  1621.  ───────────────────────────────────────────────────────────────────────
  1622.  In general,  FileDoor can  write log-records  to 3  different log-files
  1623.  with a fully free format. The three logs are:
  1624.  
  1625.  - System log
  1626.    Over  here   FileDoor   will    write   records   for  uploaded   and
  1627.    downloaded  files  (e.g.  the  log-file  that  the  BBS  program also
  1628.    maintains);
  1629.  
  1630.  - User upload-log
  1631.    Over here FileDoor will write records for uploaded files;
  1632.  
  1633.  - User download-log
  1634.    Over here FileDoor will write records for downloaded files;
  1635.  
  1636.  As told, you can  use a free format  of the log-records for  any of the
  1637.  three files BUT it is advised to make the records in the system-log  of
  1638.  the same format as the actual records, created by the BBS program.   In
  1639.  this way,  log-file analyze  programs can  include these  records as if
  1640.  they were from  the BBS itself.  The other two  logs can be  coded in a
  1641.  free style UNLESS you use  a third-party log-analyze program that  also
  1642.  included these FileDoor-specific log-files.
  1643.  
  1644.  One major and  VERY important aspect  of the next  options is, that  if
  1645.  you do not  define them (while  having the LogFile,  Downloadlog and/or
  1646.  Uploadlog options active),  FileDoor will write  EMPTY lines in  one or
  1647.  more of these logs. To be more specific:
  1648.  
  1649.  - When LogFile is set, BBSDNFormat and BBSUPFormat must also be set;
  1650.  
  1651.  - When DownloadLog is set, UseDNFormat must also be set;
  1652.  
  1653.  - When UploadLog   is set, UseUPFormat must also be set;
  1654.  
  1655.  - When a ???DNFormat or ???UpFormat  (where ??? is BBS or USE)  is set,
  1656.    you will also have to set ???DateFormat and ???TimeFormat,  otherwise
  1657.    there is no date/time stamping in the log-file.
  1658.  
  1659.  The following  options are  available (note  that in  the supplied file
  1660.  FILEDOOR.CFG, examples are present for the major BBS types).
  1661.  
  1662.  ┌─────────────────────────────────────────────────────────────────────┐
  1663.  │ BBSDNFormat [Format]                                                │
  1664.  │ BBSUpFormat [Format]                                                │
  1665.  └─────────────────────────────────────────────────────────────────────┘
  1666.  Usage   : These two  options define the  format of the  records in  the
  1667.            BBS-log  (e.g.  the  file  you  point  to,  using the LogFile
  1668.            option) for Download (BBSDNFormat) and Upload  (BBSUPFormat).
  1669.            [format] is a line with  text and/or macro's supplied by  you
  1670.            and (when  macro's are  used) replaced  by real  text by  the
  1671.            FileDoor program  at run-time.  All spaces  must be  replaced
  1672.            with an underscore ('_')  character (so [format] is  one line
  1673.            without any spaces in it).  You can use any of  the following
  1674.            macro's inside your format-line:
  1675.  
  1676.            %D will  be replaced  with the  date. To  use this macro, you
  1677.               must  also  set  the  BBSDateFormat  in your configuration
  1678.               file (see later for a description of this option);
  1679.  
  1680.            %T will  be replaced  with the  time. To  use this macro, you
  1681.               must  also  set  the  BBSTimeFormat  in your configuration
  1682.               file (see later for a description of this option);
  1683.  
  1684.            %L will be  replaced with the  letter of the  protocol as you
  1685.               have defined in the PROTOCOL option of that protocol;
  1686.  
  1687.            %N will  be  replaced  with  the  comment  belonging  to  the
  1688.               protocol and as  defined in the  PROTOCOL option for  that
  1689.               protocol (eg. 'ZModem the best !');
  1690.  
  1691.            %U will be replaced with the name of the user who  downloaded
  1692.               or uploaded the file;
  1693.  
  1694.            %P will be  replaced with the  filename AND path  of the file
  1695.               that  was  download  or  uploaded  (for uploads ALWAYS the
  1696.               normal upload path);
  1697.  
  1698.            %F will be  replaced with the  filename of the  file that was
  1699.               download or uploaded (no paths);
  1700.  
  1701.            %X will be  replaced with *DUPE*  if the file  was a dupe  at
  1702.               upload.
  1703.  
  1704.            %B will be  replaced with the filesize (in bytes) of the file
  1705.               in question;
  1706.  
  1707.            %K will be  replaced with the filesize (in KBS)  of  the file
  1708.               in question;
  1709.  
  1710.            ^M will be expanded to a CR+LF sequence in the log-file;
  1711.  
  1712.            A remark on the  %X option. If you  do NOT include it  in the
  1713.            BBSUPFormat  statement,  no  log-records  will be created for
  1714.            dupes (this is  normally the case).  If you like  a record of
  1715.            your dupes,  you can  either use  the %X  in the  UseUPFormat
  1716.            statement or even include  it in the BBSUpFormat  option, but
  1717.            remember  that  logfile  analyze  programs  can have problems
  1718.            with it;
  1719.  
  1720.  Example : BbsDNFormat +_%D_%T_FDOR_Download_[%L]_%P
  1721.            ─────────────────────────────────────────────────────────────
  1722.  Means   : That a log-record is generated with a format that looks like:
  1723.            28-Aug-91 21:00 FDOR Download [Z] C:\ZIP\DOAFILE.NOW
  1724.            The date and time are generated from the BBSDateFormat and
  1725.            BBSTimeFormat options.
  1726.            ─────────────────────────────────────────────────────────────
  1727.  
  1728.  
  1729.  ┌─────────────────────────────────────────────────────────────────────┐
  1730.  │ BBSDateFormat [Format]                                              │
  1731.  └─────────────────────────────────────────────────────────────────────┘
  1732.  Usage   : In the BBSDNFormat and BBSUpFormat, you can use the %D  macro
  1733.            that will  be replaced  with the  date. To  let this actually
  1734.            happen,  you  must  define  HOW  the  date will look like. To
  1735.            define  this,  you  must  use  this  option.  [format] is the
  1736.            format of the  date. It will  be composed of  special macro's
  1737.            and  some  text  added  by  you.  The  following  macro's are
  1738.            available:
  1739.  
  1740.            dd   : replaced with the day   (leading zeroes);
  1741.            DD   : replaced with the day   (leading spaces);
  1742.            mm   : replaced with the month (leading zeroes);
  1743.            MM   : replaced with the month (leading spaces);
  1744.            yy   : replaced with the year  (leading zeroes);
  1745.            YY   : replaced with the year  (leading spaces);
  1746.            nnn  : replaced with the name of the month (format Jan);
  1747.            NNN  : replaced with the name of the month (format JAN);
  1748.            www  : replaced with the name of the day   (format Mon);
  1749.            WWW  : replaced with the name of the day   (format MON);
  1750.  
  1751.            Further you  can use  '-' or  '/' to  separate the  different
  1752.            digits.   In [format]  any spaces  must be  replaced with  an
  1753.            underscore character.
  1754.  
  1755.  Example : BbsDateFormat dd-nnn-yy
  1756.            ─────────────────────────────────────────────────────────────
  1757.  Means   : Will be expanded to 01-Aug-91 (depending on the date)
  1758.            ─────────────────────────────────────────────────────────────
  1759.  
  1760.  
  1761.  ┌─────────────────────────────────────────────────────────────────────┐
  1762.  │ BBSTimeFormat [Format]                                              │
  1763.  └─────────────────────────────────────────────────────────────────────┘
  1764.  Usage   : In the BBSDNFormat and BBSUpFormat, you can use the %T  macro
  1765.            that will  be replaced  with the  time. To  let this actually
  1766.            happen,  you  must  define  HOW  the  time will look like. To
  1767.            define  this,  you  must  use  this  option.  [format] is the
  1768.            format of the  time. It will  be composed of  special macro's
  1769.            and  some  text  added  by  you.  The  following  macro's are
  1770.            available:
  1771.  
  1772.            hh   : replaced with the hour  (leading zeroes);
  1773.            HH   : replaced with the day   (leading spaces);
  1774.            mm   : replaced with the min   (leading zeroes);
  1775.            MM   : replaced with the min   (leading spaces);
  1776.            ss   : replaced with the sec   (leading zeroes);
  1777.            SS   : replaced with the sec   (leading spaces);
  1778.            t    : replaced with the 'a' or 'p' for 'am' and 'pm'
  1779.            e    : replaced with the 'm' from 'am' or 'pm'
  1780.  
  1781.            Further you  can use  ':' or  ' '  to separate  the different
  1782.            digits.  In  [format]  any  spaces  must  be replaced with an
  1783.            underscore character.
  1784.  
  1785.  Example : BbsTimeFormat hh:mm:ss
  1786.            ─────────────────────────────────────────────────────────────
  1787.  Means   : Will be expanded to 21:00:01 (depending on the time)
  1788.            ─────────────────────────────────────────────────────────────
  1789.  
  1790.  
  1791.  ┌─────────────────────────────────────────────────────────────────────┐
  1792.  │ UseDNFormat [Format]                                                │
  1793.  │ UseUpFormat [Format]                                                │
  1794.  └─────────────────────────────────────────────────────────────────────┘
  1795.  Usage   : These two  options define the  format of the  records in  the
  1796.            log  pointed  by  DownloadLog  (UseDNFormat)  and   UploadLog
  1797.            (UseUPFormat).  They  work  the  same  as the BBSDNFormat and
  1798.            BBSUPFormat options !
  1799.  
  1800.  Example : See BBSDNFormat
  1801.            ─────────────────────────────────────────────────────────────
  1802.  Means   : See BBSDNFormat
  1803.            ─────────────────────────────────────────────────────────────
  1804.  
  1805.  
  1806.  ┌─────────────────────────────────────────────────────────────────────┐
  1807.  │ BBSMAFormat [Format]                                                │
  1808.  └─────────────────────────────────────────────────────────────────────┘
  1809.  Usage   : This option does the  same as the BBDSNFormat  option but  is
  1810.            used for the  FILEMAIN program. You  can now add  a different
  1811.            log-format for entries made by FILEMAIN.EXE.
  1812.  
  1813.  Example : See BBSDNFormat
  1814.            ─────────────────────────────────────────────────────────────
  1815.  Means   : See BBSDNFormat
  1816.            ─────────────────────────────────────────────────────────────
  1817.  
  1818.  
  1819.  ┌─────────────────────────────────────────────────────────────────────┐
  1820.  │ UseDateFormat [Format]                                              │
  1821.  └─────────────────────────────────────────────────────────────────────┘
  1822.  Usage   : Used for  the date format in the UseUPFormat  and UseDNFormat
  1823.            options. The same as BBSDateFormat.
  1824.  
  1825.  Example : See BBSDateFormat
  1826.            ─────────────────────────────────────────────────────────────
  1827.  Means   : See BBSDateFormat
  1828.            ─────────────────────────────────────────────────────────────
  1829.  
  1830.  
  1831.  ┌─────────────────────────────────────────────────────────────────────┐
  1832.  │ UseTimeFormat [Format]                                              │
  1833.  └─────────────────────────────────────────────────────────────────────┘
  1834.  Usage   : Used for  the time format in the UseUPFormat  and UseDNFormat
  1835.            options. The same as BBSTimeFormat.
  1836.  
  1837.  Example : See BBSTimeFormat
  1838.            ─────────────────────────────────────────────────────────────
  1839.  Means   : See BBSTimeFormat
  1840.            ─────────────────────────────────────────────────────────────
  1841.  
  1842.  
  1843.  
  1844.  3.3.6 Other statements, not related to protocol definition
  1845.  ───────────────────────────────────────────────────────────────────────
  1846.  In this chapter a lot of  special options are described that will  have
  1847.  some meaning on the working, the 'looks' and 'feel' of FileDoor.
  1848.  
  1849.  
  1850.  ┌─────────────────────────────────────────────────────────────────────┐
  1851.  │ Color [lowmenu] [highmenu] [attention] [statusbar] [errors]         │
  1852.  │       [text]    [size UnC] [Size  Com] [date]      [time]           │
  1853.  └─────────────────────────────────────────────────────────────────────┘
  1854.  Usage    : You can  overrule the default  colors to make  FileDoor look
  1855.            more the way your own BBS looks. There are 10 items that  can
  1856.            be overruled.  They are  the menu-color  (low) [lowmenu], the
  1857.  
  1858.            [lowmenu]   The (low) color of the menu entries;
  1859.  
  1860.            [highmenu]  The (high) color of the menu entries;
  1861.  
  1862.            [attention] The color of important highlighted fields;
  1863.  
  1864.            [statusbar] The color of the local status-bar;
  1865.  
  1866.            [errors]    The color of the errors (when displayed);
  1867.  
  1868.            [text]      The color for various texts;
  1869.  
  1870.            [size unC]  The color for uncompressed sizes (internal view);
  1871.  
  1872.            [size Com]  The color for compressed sizes (internal view);
  1873.  
  1874.            [date]      The color for dates (internal view);
  1875.  
  1876.            [time]      The color for times (internal view);
  1877.  
  1878.            The last 5  colors  are  only used   inside the <V>   and <I>
  1879.            options in the download selection menu.
  1880.  
  1881.            Each of these variables must be coded when Color (or  Colour)
  1882.            is used. They  must contain a  number between 0  and 255. The
  1883.            color you want to use is made up with the following formula:
  1884.  
  1885.            [foreground-color] + (16 * [background-color])      (noblink)
  1886.  
  1887.            or
  1888.  
  1889.            [foreground-color] + (16 * [background-color]) + 128  (blink)
  1890.  
  1891.            [Foreground-color] can  be a  number from  0 to  15, and  the
  1892.            [background-color] can be a number from 0 to 7. When you  use
  1893.            higher  numbers  on  background-color  (8  to  15),  you  get
  1894.            blinking reversed text (not nice).
  1895.  
  1896.            The numbers 0 to 15 stand for:
  1897.  
  1898.            0  = Black              8  = DarkGray
  1899.            1  = Blue               9  = LightBlue
  1900.            2  = Green              10 = LightGreen
  1901.            3  = Cyan      (sea   ) 11 = LightCyan
  1902.            4  = Red                12 = LightRed
  1903.            5  = Magenta   (purple) 13 = LightMagenta (light purple)
  1904.            6  = Brown     (orange) 14 = Yellow
  1905.            7  = LightGray          15 = White
  1906.  
  1907.            So to create a cyan on black item, this will come to 3 +  (16
  1908.            * 0) = 3 and for a white  on red text this will come to 15  *
  1909.            (16 * 4) = 79. For blinking, add 128 to the number.
  1910.  
  1911.  Example : Color 2 10 14 47 12 6 7 8 4 12
  1912.            ─────────────────────────────────────────────────────────────
  1913.  Means   : Create a 'green based' FileDoor
  1914.            ─────────────────────────────────────────────────────────────
  1915.  
  1916.  
  1917.  ┌─────────────────────────────────────────────────────────────────────┐
  1918.  │ HelpExitKeys [helpkey] [exitkey]                                    │
  1919.  └─────────────────────────────────────────────────────────────────────┘
  1920.  Usage   : Normally, FileDoor uses the '?' key for help and the '-'  key
  1921.            to terminate (both in  the protocol selection menu).  If you
  1922.            would like some other characters  (like 'H' and 'Q') you  can
  1923.            include them in the  HelpExitKeys option. ALWAYS define  this
  1924.            option BEFORE any PROTOCOL option because FileDoor checks  to
  1925.            see if there are duplicate keys used for different  protocols
  1926.            and/or functions.
  1927.  
  1928.            [helpkey] is the key you plan to use for help-information  in
  1929.                      the protocol menu (normally ?);
  1930.  
  1931.            [exitkey] is  the  key  you  plan  to  use  to exit from  the
  1932.                      protocol menu (normally -).
  1933.  
  1934.  Example : HelpExitKeys H Q
  1935.            ─────────────────────────────────────────────────────────────
  1936.  Means   : Use H for help en Q to exit inside the protocol menu
  1937.            ─────────────────────────────────────────────────────────────
  1938.  
  1939.  
  1940.  ┌─────────────────────────────────────────────────────────────────────┐
  1941.  │ StatusLine                                                          │
  1942.  └─────────────────────────────────────────────────────────────────────┘
  1943.  Usage   : FileDoor   can  supply  a   status-line at the bottom of  the
  1944.            display. Some  SysOps like  it, some  don't. If  you want  to
  1945.            have a  full status-line  at the  bottom, you  should include
  1946.            this  option,  otherwise  you  won't  get a status-line. With
  1947.            large displays and when  you display many ANS/ASC  files, the
  1948.            status-line can slow the speed somewhat (no visual change  on
  1949.            a 16800 connection though).
  1950.  
  1951.  Example : StatusLine
  1952.            ─────────────────────────────────────────────────────────────
  1953.  Means   : See description
  1954.            ─────────────────────────────────────────────────────────────
  1955.  
  1956.  
  1957.  ┌─────────────────────────────────────────────────────────────────────┐
  1958.  │ NoDupeStat                                                          │
  1959.  └─────────────────────────────────────────────────────────────────────┘
  1960.  Usage   : FileDoor will  display a little  progress-bar on the   remote
  1961.            (and local) screen when it is searching for duplicate  files.
  1962.            If you dislike the looks of  it, you can remove it by  adding
  1963.            this option to FILEDOOR.CFG.
  1964.  
  1965.  Example : NoDupeStat
  1966.            ─────────────────────────────────────────────────────────────
  1967.  Means   : See description
  1968.            ─────────────────────────────────────────────────────────────
  1969.  
  1970.  
  1971.  ┌─────────────────────────────────────────────────────────────────────┐
  1972.  │ NoFindStat                                                          │
  1973.  └─────────────────────────────────────────────────────────────────────┘
  1974.  Usage   : FileDoor will  display a little  progress-bar on the   remote
  1975.            (and local) screen when  it is searching for  selected files.
  1976.            If you dislike the looks of  it, you can remove it by  adding
  1977.            this option to FILEDOOR.CFG.
  1978.  
  1979.  Example : NoFindStat
  1980.            ─────────────────────────────────────────────────────────────
  1981.  Means   : See description
  1982.            ─────────────────────────────────────────────────────────────
  1983.  
  1984.  
  1985.  ┌─────────────────────────────────────────────────────────────────────┐
  1986.  │ MenuIfOnlyOne                                                       │
  1987.  └─────────────────────────────────────────────────────────────────────┘
  1988.  Usage   : If you include only  ONE protocol (f.i. Zmodem  and no  other
  1989.            protocols), FileDoor can go directly into the  file-selection
  1990.            menu  without  displaying  the  protocol-menu (why should you
  1991.            need a  menu when  there is  only one  choice). If  you still
  1992.            want to have the  menu (f.i. to give  the user the chance  to
  1993.            exit in simple way), you  must add this option. In  that case
  1994.            FileDoor  will  display  the  protocol-menu  with the one and
  1995.            only choice available to the user.
  1996.  
  1997.  Example : MenuIfOnlyOne
  1998.            ─────────────────────────────────────────────────────────────
  1999.  Means   : See description
  2000.            ─────────────────────────────────────────────────────────────
  2001.  
  2002.  
  2003.  ┌─────────────────────────────────────────────────────────────────────┐
  2004.  │ ForceEdit                                                           │
  2005.  └─────────────────────────────────────────────────────────────────────┘
  2006.  Usage   : If the user supplies  the comment for an  upload file  BEFORE
  2007.            the transfer, FileDoor  will not ask  for that comment  again
  2008.            AFTER  the  transfer  unless  it  is  too small. The user can
  2009.            supply comments in two ways:
  2010.  
  2011.            - In FileDoor's upload menu;
  2012.  
  2013.            - While inside Bimodem <tm>, in which case Bimodem will  send
  2014.              the comment along with the file;
  2015.  
  2016.            If  you  include  the  ForceEdit  option, the user will still
  2017.            have  to  press  ENTER  on  every comment AFTER the transfer,
  2018.            even if there  is a complete  comment available. Without  the
  2019.            option,  FileDoor  will  not  ask  for input anymore and will
  2020.            take the (already) supplied comment as-is.
  2021.  
  2022.  Example : ForceEdit
  2023.            ─────────────────────────────────────────────────────────────
  2024.  Means   : See description
  2025.            ─────────────────────────────────────────────────────────────
  2026.  
  2027.  
  2028.  ┌─────────────────────────────────────────────────────────────────────┐
  2029.  │ InternalOverUser                                                    │
  2030.  └─────────────────────────────────────────────────────────────────────┘
  2031.  Usage   : When  you run specific programs inside  your ExitAfterUploadx
  2032.            exit(s) like  DISP's MTA.EXE,  it is  possible to  obtain the
  2033.            comment from files like FILE_ID.DIZ files and pass them  from
  2034.            MTA.EXE to FileDoor. If you install MTA.EXE and  FILEDOOR.EXE
  2035.            in this way, you have the following choices:
  2036.  
  2037.            - FileDoor will  always take the  comment obtained by  MTA if
  2038.              it is present, otherwise it will ask for a comment. If  the
  2039.              user  supplied  a  comment  before  the  transfer,  it   is
  2040.              overwritten by  the comment  obtained from  the exit (MTA).
  2041.              FileDoor only  works in  this way  when you  add the option
  2042.              InternalOverUser into FILEDOOR.CFG;
  2043.  
  2044.            - If  you do  NOT add  the InternalOverUser  option, FileDoor
  2045.              will  use  the  comment  supplied  by  the  user before the
  2046.              transfer (if  any) and  if there  was not  such a  comment,
  2047.              FileDoor will take the comment from the exit (if any);
  2048.  
  2049.  Example : InternalOverUser
  2050.            ─────────────────────────────────────────────────────────────
  2051.  Means   : See description
  2052.            ─────────────────────────────────────────────────────────────
  2053.  
  2054.  
  2055.  ┌─────────────────────────────────────────────────────────────────────┐
  2056.  │ NotAvailText [text]                                                 │
  2057.  └─────────────────────────────────────────────────────────────────────┘
  2058.  Usage   : On  two places  FileDoor reports  '[FileDoor] no  description
  2059.            available'. This is while  in the file-selection display  and
  2060.            in  the  information  file,  when  a  file has no description
  2061.            inside  the  FILES.BBS  (unless  HideFiles  prevents FileDoor
  2062.            from reporting the file at all).  You can alter this text  to
  2063.            any text you like yourself.
  2064.  
  2065.            [text] is the new text that is used as a replacement for  the
  2066.                   default text. It  can be up  to 47 characters  and all
  2067.                   spaces must be codes as underscore characters.
  2068.  
  2069.  Example : NotAvailText For_this_file_there_is_no_comment
  2070.            ─────────────────────────────────────────────────────────────
  2071.  Means   : Will for FileDoor to put 'For this file there is no comment'
  2072.            inside the screens when there is no comment in FILES.BBS
  2073.            available.
  2074.            ─────────────────────────────────────────────────────────────
  2075.  
  2076.  
  2077.  ┌─────────────────────────────────────────────────────────────────────┐
  2078.  │ ANSASC [type] [name]                                                │
  2079.  └─────────────────────────────────────────────────────────────────────┘
  2080.  Usage   : By   default,  FileDoor  will   use  a  number   of  standard
  2081.            ANSI/ASCII files  on certain  occasion. These  files must  be
  2082.            located  in  the  directory  pointed  to  by  the FileDoorDir
  2083.            option. These  files have  standard names  which can conflict
  2084.            with names that  you already use  for other programs  (doors,
  2085.            BBS itself and so on).
  2086.  
  2087.            The ANSASC options give you the chance to overrule the  names
  2088.            of  one  or  more  of  the  standard  ANSI/ASCII  files  that
  2089.            FileDoor needs.
  2090.  
  2091.            [type] must be  a 2-character code  of the filename  you want
  2092.                   to alter (see below);
  2093.  
  2094.            [name] must be a  1 to 8 character  (new) name that you  want
  2095.                   to  assign  (see  below  for  the  internal   FileDoor
  2096.                   default names);
  2097.  
  2098.            The following ANSI/ASCII files  are used by FileDoor  and can
  2099.            be overruled with other names:
  2100.  
  2101.            [type] [name]    [description]
  2102.            -------------------------------------------------------------
  2103.            HU     HLP_UP    Help file for uploads
  2104.            HD     HLP_DOWN  Help file for downloads
  2105.            HT     HLP_TAGS  Help file for tagging options
  2106.            HS     HLP_SELE  Help file for file-selection
  2107.            HP     HLP_SUPL  Help file for upload specification
  2108.            UW     HLP_UNWA  Help file with unwanted       reject reason
  2109.            0B     HLP_EMPT  Help file with 0-bytes        reject reason
  2110.            OL     HLP_TOLD  Help file with too-old        reject reason
  2111.            RJ     HLP_REJE  Help file with description of reject reason
  2112.            DU     HLP_DUPE  Help file with duplicates     reject reason
  2113.            NA     HLP_NARC  Help file with non-archive reduction reason
  2114.            UT     HLP_UTNX  Help file with 'THANKS FOR UPLOAD' text
  2115.            GB     GOODBYE   Help file to display before internal logoff
  2116.            MU     MNU_UP    External menu-file for uploads
  2117.            MD     MNU_DOWN  External menu-file for downloads
  2118.            EM     ERR_10FL  External error-text with 10 or more errors
  2119.            ES     ERR_SELF  External error-text with already sel. file
  2120.            ER     ERR_RATI  External error-text when denied by ratio
  2121.            ED     ERR_DLIM  External error-text when denied by limits
  2122.            ET     ERR_SEST  External error-text when denied by time
  2123.            EX     ERR_EXIT  External error-text when denied by exit
  2124.            -------------------------------------------------------------
  2125.  
  2126.            You  should  examine  the  supplied  examples.  Normally  the
  2127.            ERR*.* files must be  created without a clear-screen  because
  2128.            they are put under the current text. Looking at the  examples
  2129.            will give you a good clue.
  2130.  
  2131.            If you don't  want to use  one or more  help/menu/error texts
  2132.            from ANSI/ASCII  texts, you  can supply  a non-existing  name
  2133.            like  RIDINGH.OOD  in  which  case  FileDoor will display its
  2134.            internal text (quicker but less nice).
  2135.  
  2136.            FileDoor makes  no usage  (yet) of  special codes  inside the
  2137.            ANSI-files as the BBS program does. In most cases this  means
  2138.            that you must overrule the  GOODBYE file with one of  you own
  2139.            because most  SysOp's have  put some  extended ANSI  codes in
  2140.            this screen to display the users name, the time and so on.
  2141.  
  2142.  
  2143.  Example : AnsAsc HU MYHELP_U (look for MYHELP_U.A?? and not HLP.UP.A??)
  2144.  Example : AnsAsc GB XFGOODB  (look for XFGOODB.A?? and not GOODBYE.A??)
  2145.            ─────────────────────────────────────────────────────────────
  2146.  Means   : Overrule name for the GOODBYE screen (normally GOODBYE.Axx)
  2147.            with XFGOODB. FileDoor will now look for XFDOODB.Axx !
  2148.            ─────────────────────────────────────────────────────────────
  2149.  
  2150.  
  2151.  ┌─────────────────────────────────────────────────────────────────────┐
  2152.  │ AutoSearch                                                          │
  2153.  └─────────────────────────────────────────────────────────────────────┘
  2154.  Usage   : If set,  a global transfer  will be enabled.  All file  areas
  2155.            will be searched  for the wanted  file(s). Full security  and
  2156.            flag support will prevent  users from downloading files  from
  2157.            areas they don't have access to.
  2158.  
  2159.  Example : AutoSearch
  2160.            ─────────────────────────────────────────────────────────────
  2161.  Means   : See description
  2162.            ─────────────────────────────────────────────────────────────
  2163.  
  2164.  
  2165.  ┌─────────────────────────────────────────────────────────────────────┐
  2166.  │ DownloadInfo [file] {default}                                       │
  2167.  └─────────────────────────────────────────────────────────────────────┘
  2168.  Usage   : FileDoor contains an  option to ask the user if she/he  wants
  2169.            the comments for  the downloaded files  copied from your  own
  2170.            FILES.BBS's to  a special  file that  can be  downloaded. The
  2171.            user can enter /INFO in the selection option or FileDoor will
  2172.            add the download information by itself (when using a batch
  2173.            protocol).
  2174.  
  2175.            If you would  like your users  to have this  option, you must
  2176.            create a text-file that contains the header of the file  that
  2177.            is sent  when the  user selects  /INFO. You  can include  a
  2178.            commercial or some information of interest.
  2179.  
  2180.            The  temporary  file  for  the  user  is  created in the same
  2181.            directory that contains [file]  and is deleted when  the user
  2182.            exits from FileDoor  (even when the  file was not  downloaded
  2183.            at all).
  2184.  
  2185.            The user will receive a file in the FILES.BBS style and as  a
  2186.            service,  your  files-counter  (if  defined  in  FileDoor) is
  2187.            removed from the comment. The comment can be up to 240  bytes
  2188.            in length and  FileDoor will be  able to support  the QFV/C/F
  2189.            <tm> +-comment-lines in your FILES.BBS.
  2190.  
  2191.            [file]    must  point   to  a  text-file. The parameter  must
  2192.                      contain the  drive, directory  and filename  of the
  2193.                      file;
  2194.  
  2195.            {default} can either  be set to  Y or N.  When the user  gets
  2196.                      the  question  if  she/he  wants  to  include   the
  2197.                      download-info  file,  the  value  of this parameter
  2198.                      will rule the assigned  default when the user  hits
  2199.                      the [ENTER] key. If  Y, [ENTER] will assign  a 'Y',
  2200.                      otherwise the default will be N.
  2201.  
  2202.  Example : DownloadInfo D:\BBS\RAX\XFDFBBSI.TXT Y
  2203.            ─────────────────────────────────────────────────────────────
  2204.  Means   : D:\BBS\RAX\XFDFBBSI.TXT contains the commercial (or info)
  2205.            that will be the header of the information-file that the
  2206.            user will receive (when asked). The default answer (when
  2207.            the user presses [ENTER]) is 'Y'es.
  2208.            ─────────────────────────────────────────────────────────────
  2209.  
  2210.  
  2211.  ┌─────────────────────────────────────────────────────────────────────┐
  2212.  │ ExactMatch                                                          │
  2213.  └─────────────────────────────────────────────────────────────────────┘
  2214.  Usage   : If set, FileDoor  will not ask questions when an exact  match
  2215.            between mask  and filename  (e.g. the  mask does  not contain
  2216.            wildcards)  is  found.  Also  searching  for other files with
  2217.            this  mask  is  also  disabled.  Other  masks  will  still be
  2218.            searched for and everything stays  the same as before when  a
  2219.            user includes wildcards  in the mask.  See chapter 4.5  for a
  2220.            discussion on file selection.
  2221.  
  2222.  Example : ExactMatch
  2223.            ─────────────────────────────────────────────────────────────
  2224.  Means   : See description
  2225.            ─────────────────────────────────────────────────────────────
  2226.  
  2227.  
  2228.  ┌─────────────────────────────────────────────────────────────────────┐
  2229.  │ QuickMatch                                                          │
  2230.  └─────────────────────────────────────────────────────────────────────┘
  2231.  Usage   : If  set, FileDoor  will not  ask questions  when a  match  is
  2232.            found (e.g. the first match)  independent of the fact if  the
  2233.            user  used  wildcards  in  the  mask.  See  chapter 4.5 for a
  2234.            discussion on file selection.
  2235.  
  2236.  Example : QuickMatch
  2237.            ─────────────────────────────────────────────────────────────
  2238.  Means   : See description
  2239.            ─────────────────────────────────────────────────────────────
  2240.  
  2241.  
  2242.  ┌─────────────────────────────────────────────────────────────────────┐
  2243.  │ HideFiles [highsec] {lowsec}                                        │
  2244.  └─────────────────────────────────────────────────────────────────────┘
  2245.  Usage  : This (optional) feature  can be used  for files that  are  not
  2246.           reported in the FILES.BBS file. With this option you can  make
  2247.           a difference between your  'normal' guests, your 'new'  guests
  2248.           and those that you don't want to loose for any money.
  2249.  
  2250.           [highsec] This must  be a security-level.  All user with  this
  2251.                     level (and  above) will  see files,  not reported in
  2252.                     FILES.BBS, while they are selecting files. They  can
  2253.                     also select the files;
  2254.  
  2255.           {lowsec}  This parameter is  optional. If set, all users  with
  2256.                     this  security  level  or  higher  (but  lower  than
  2257.                     [highsec]  can  SELECT  files  not  reported  inside
  2258.                     FILES.BBS  but  ONLY  when  they  supply  the  exact
  2259.                     file-name   (no   wildcard).    With   a    wildcard
  2260.                     file-search, they will not be shown to those users;
  2261.  
  2262.            If you only set [highsec], all users with a lower level  than
  2263.            [highsec] are not able to  select nor see the files  that are
  2264.            NOT reported in FILES.BBS.
  2265.  
  2266.  Example : HideFiles 10000 100
  2267.            ─────────────────────────────────────────────────────────────
  2268.  Means   : Only users with level 10000 or above can see and select
  2269.            files which are NOT in FILES.BBS. All users with level
  2270.            100 to 9999 can select (and see) files which are not in
  2271.            FILES.BBS if they supply the EXACT name;
  2272.            ─────────────────────────────────────────────────────────────
  2273.  
  2274.  
  2275.  ┌─────────────────────────────────────────────────────────────────────┐
  2276.  │ FilesCount {format}                                                 │
  2277.  └─────────────────────────────────────────────────────────────────────┘
  2278.  Usage   : If used, after a download, all FILES.BBS files will have  the
  2279.            right file-counters updated.  In this way,  you will be  able
  2280.            to  track  the  number  of  downloads  of  each  file in your
  2281.            library.
  2282.  
  2283.            {format} indicates the  number of digits  used in your  files
  2284.                     counter  AND  the  characters  that  incapsulate the
  2285.                     counter. You can use @  or # for the counter,  where
  2286.                     @  will  cause  tailing  zeroes  and  #  will  cause
  2287.                     tailing spaces and any combination of  incapsulation
  2288.                     characters.  If  {format} is left  out, [@@] is  the
  2289.                     used default.
  2290.  
  2291.            FileDoor uses  a smart  update. Downloads  of multiple  files
  2292.            are collected and FILES.BBS is opened only once.
  2293.  
  2294.  Example : FilesCount [@@@]  (will cause [001] xxxxx)
  2295.            ─────────────────────────────────────────────────────────────
  2296.  Means   : [001] will be added to the FILES.BBS when this is the first
  2297.            download.
  2298.            ─────────────────────────────────────────────────────────────
  2299.  
  2300.  
  2301.  ┌─────────────────────────────────────────────────────────────────────┐
  2302.  │ UploadName [place]                                                  │
  2303.  └─────────────────────────────────────────────────────────────────────┘
  2304.  Usage   : If used, FileDoor will  place the name of  the uploader  into
  2305.            the  FILES.BBS  entry  that  it  will create for the uploaded
  2306.            file(s).
  2307.  
  2308.            [place] can  be  either  F,  B,  +  or  +D.  If 'F' is  used,
  2309.                    FileDoor will  place the  uploaders name  in front of
  2310.                    the comment  (behind any  optional file-counter).  If
  2311.                    'B' is used, FileDoor will place the name BEHIND  the
  2312.                    comment.  If  '+'  is  used,  FileDoor  will create a
  2313.                    DISP-compatible +-comment-line in the FILES.BBS  with
  2314.                    the name of  the uploaded. The  same goes for  +D but
  2315.                    in this case also the date will be added to the  name
  2316.                    of the uploader.
  2317.  
  2318.            The  format  of  the  name  depends on the [place] parameter.
  2319.            Here  are  some  examples  from  FILES.BBS with the different
  2320.            [place] options:
  2321.  
  2322.            Using 'F' :  ALLFILES.ZIP [Rob van.hoeven] My allfiles
  2323.                         or
  2324.                         ALLFILES.ZIP [000] [Rob van.hoeven] My allfiles
  2325.  
  2326.            Using 'B' :  ALLFILES.ZIP My allfiles [Rob van.hoeven]
  2327.                         or
  2328.                         ALLFILES.ZIP [000] My allfiles [Rob van.hoeven]
  2329.  
  2330.            Using '+' :  ALLFILES.ZIP My allfiles
  2331.                          +Uploaded by: Rob van.hoeven
  2332.                         or
  2333.                         ALLFILES.ZIP [000] My allfiles
  2334.                          +Uploaded by: Rob van.hoeven
  2335.  
  2336.            Using '+D':  ALLFILES.ZIP My allfiles
  2337.                          +Uploaded by: Rob van.hoeven on mm/dd/yy hh:mm
  2338.                         or
  2339.                         ALLFILES.ZIP [000] My allfiles
  2340.                          +Uploaded by: Rob van.hoeven on mm/dd/yy hh:mm
  2341.  
  2342.            As you can see, there  are a number of possible  entries. You
  2343.            should remember  that FileDoor  will subtract  the length  of
  2344.            the user's name from the  comment-length when using the F  or
  2345.            B parameters. This can result in very short descriptions.
  2346.  
  2347.  Example : UploadName +
  2348.            ─────────────────────────────────────────────────────────────
  2349.  Means   : See description
  2350.            ─────────────────────────────────────────────────────────────
  2351.  
  2352.  
  2353.  ┌─────────────────────────────────────────────────────────────────────┐
  2354.  │ CommentLength  [option1] [option2]                                  │
  2355.  └─────────────────────────────────────────────────────────────────────┘
  2356.  Usage   : This   will  define  the   minimum and maximum length of  the
  2357.            file-descriptions for  uploaded files.   You must  supply the
  2358.            real minimum and maximum length including the  files-counter.
  2359.            Defaults are 20  and 47. You  can define a  length up to  240
  2360.            characters.
  2361.  
  2362.            [option1] is  a numeric  digit (20  or more)  of the  minimum
  2363.                      length of the file-comment;
  2364.  
  2365.            [option2]  is  a  numeric  digit  (21  to 240) of the maximum
  2366.                      length of the file-comment;
  2367.  
  2368.  Example : CommentLength  20  47
  2369.            ─────────────────────────────────────────────────────────────
  2370.  Means   : Comments that are supply must be at least 20 bytes and can
  2371.            not exceed 47 characters !
  2372.            ─────────────────────────────────────────────────────────────
  2373.  
  2374.  
  2375.  ┌─────────────────────────────────────────────────────────────────────┐
  2376.  │ FreeFile [mask] {NOTIME}                                            │
  2377.  │ FreeFile [path] {NOTIME}                                            │
  2378.  └─────────────────────────────────────────────────────────────────────┘
  2379.  Usage   : If set,  FileDoor will not calculate the kB's  downloaded for
  2380.            the supplied file names.
  2381.  
  2382.            [mask]   In this form, FreeFile works GLOBALLY on all  areas.
  2383.                     [mask] is  a file-mask  (wildcards are  allowed) and
  2384.                     marks all files that won't be counted for DOWNLOAD;
  2385.  
  2386.            [path]   In this form,  FreeFile works LOCALLY  for the  mask
  2387.                     you supply  and only  in the  directory you  supply.
  2388.                     [path] must be  a drive (optionally),  directory and
  2389.                     file-mask  (wildcards   allowed)  that   marks   the
  2390.                     file(s) that won't be counted for DOWNLOAD;
  2391.  
  2392.            {NOTIME} The NOTIME parameter  is optional and when  supplied
  2393.                     will tell FileDoor that  the file(s) that match  the
  2394.                     previous  [mask]  or  [path]  can  be  selected (for
  2395.                     free) EVEN if there isn't enough time for  download.
  2396.                     This can be  useful for new  users who can  download
  2397.                     the ALLFILES or BBS-manual  while the can only  stay
  2398.                     a short while on the BBS;
  2399.  
  2400.            File-masks that  are supplied  with FreeFile  options (up  to
  2401.            255 of  each type,  so 255  without directory  and 255  with)
  2402.            will be merged  with those that  come from FILES.CTL  (if you
  2403.            use  that  file  and  have  assigned it with the FILESCTLPath
  2404.            option).
  2405.  
  2406.  Example : FreeFile  D:\BBS\RAX\FILE\DISP\MT*.* NOTIME
  2407.            ─────────────────────────────────────────────────────────────
  2408.  Means   : All files with file-mask MT*.* in D:\BBS\RAX\FILE are free
  2409.            for download, even when there isn't enough time to download
  2410.            the file.
  2411.            ─────────────────────────────────────────────────────────────
  2412.  
  2413.  
  2414.  ┌─────────────────────────────────────────────────────────────────────┐
  2415.  │ ExcludeFile [mask]                                                  │
  2416.  │ ExcludeFile [path]                                                  │
  2417.  └─────────────────────────────────────────────────────────────────────┘
  2418.  Usage   : Normally  FileDoor will  display ALL  files that  match   the
  2419.            users selection  (provided the  security level  is ok).  Only
  2420.            when  you  use  the  HideFiles  option, files, not inside the
  2421.            FILES.BBS file, will not be shown.
  2422.  
  2423.            When  you  do  not  include  HideFiles  and you don't use the
  2424.            ExcludeFile  option,  FileDoor  will  also  show  files  like
  2425.            FILES.BBS, DIR.BBS, PFILES.BBS  (and their BAK  versions) and
  2426.            more of these files that are  present in all areas but of  no
  2427.            use for the user.
  2428.  
  2429.            You can use the ExcludeFile  option (up to 255 of  each type)
  2430.            to exclude these global files.
  2431.  
  2432.            [mask] In this  form, you supply  a file-mask (wildcards  are
  2433.                   allowed) of files  that you don't  want to show  up in
  2434.                   ANY of the areas (GLOBAL option);
  2435.  
  2436.            [path] In  this form,  you supply  a file-mask  with a  drive
  2437.                   (optional) and directory  (mandatory) of file(s)  that
  2438.                   you don't want  to show up  in a specific  area (LOCAL
  2439.                   option).
  2440.  
  2441.            You  should  AT  LEAST  include  options  to exclude FILES.*,
  2442.            PFILES.* and DIR.*  unless you make  it possible to  download
  2443.            these files.
  2444.  
  2445.  Example : ExcludeFile  FILES.*
  2446.            ─────────────────────────────────────────────────────────────
  2447.  Means   : FileDoor will not show files which match FILES.* (like the
  2448.            FILES.BBS, FILES.BAK, FILES.MTA and so on) in any area. They
  2449.            can also not be selected for download.
  2450.            ─────────────────────────────────────────────────────────────
  2451.  
  2452.  
  2453.  ┌─────────────────────────────────────────────────────────────────────┐
  2454.  │ DefaultExtension [extension]                                        │
  2455.  └─────────────────────────────────────────────────────────────────────┘
  2456.  Usage   : Set   the  default  extension   for  wildcards  or    partial
  2457.            filenames.   This  will  also   be  displayed  in  the   file
  2458.            selection part  of FileDoor.   If no  extensions are  used in
  2459.            your file-base remember to set [extension] to '*'.  When  set
  2460.            to ZIP (for example), a  filename MYBBS* will be expanded  to
  2461.            MYBBS*.ZIP and  FileDoor will  search for  that file.  If the
  2462.            user enters any extension  or wildcard as extension,  none is
  2463.            added by FileDoor.
  2464.  
  2465.            [extension] must by  the 1 to  3 digit extension  that is the
  2466.                        most frequently used extension on your BBS.
  2467.  
  2468.            You can supply up to 5 different DefaultExtension options  in
  2469.            FILEDOOR.CFG.  FileDoor  will  check  all eligible files with
  2470.            the supplied extensions.
  2471.  
  2472.  Example : DefaultExtension ZIP
  2473.            ─────────────────────────────────────────────────────────────
  2474.  Means   : If a user enters ALLFILES, FileDoor will search for a file
  2475.            called ALLFILES or ALLFILES.ZIP.
  2476.            ─────────────────────────────────────────────────────────────
  2477.  
  2478.  
  2479.  ┌─────────────────────────────────────────────────────────────────────┐
  2480.  │ Unwanted [mask]                                                     │
  2481.  └─────────────────────────────────────────────────────────────────────┘
  2482.  Usage   : Set   any  filename  or   extension  that is unwanted for  an
  2483.            upload  on  your  system.  There  can  be  up to 100 Unwanted
  2484.            options all together.
  2485.  
  2486.            [mask] is  the file-mask  (wildcards allowed)  of files  that
  2487.                   are unwanted.
  2488.  
  2489.            Be warned. The /UNWANTED  files from FILES.CTL and  the files
  2490.            from BADFILES.CTL  are also  added to  the range  of unwanted
  2491.            files. Each is counted as a normal Unwanted option !
  2492.  
  2493.  Example : Unwanted ARJ2??.*
  2494.            ─────────────────────────────────────────────────────────────
  2495.  Means   : If a file that matches this mask is uploaded or given as an
  2496.            upload, FileDoor will mark it as unwanted and reject the
  2497.            file (after transfer it is removed and not counted).
  2498.            ─────────────────────────────────────────────────────────────
  2499.  
  2500.  
  2501.  ┌─────────────────────────────────────────────────────────────────────┐
  2502.  │ NoArchiveCredit [amount]                                            │
  2503.  └─────────────────────────────────────────────────────────────────────┘
  2504.  Usage   : Set the  credit for non-archived  files. FileDoor will   test
  2505.            the  uploaded  file  for  any  known  compression method. The
  2506.            calculation   is   as   follows:    (filesize   /   100)    *
  2507.            NoArchiveCredit.  You  do  not  have  to  tell  FileDoor  the
  2508.            extensions  or  archives,  because  FileDoor will look inside
  2509.            any uploaded file  by itself and  will detect ARC,  PAK, PKA,
  2510.            ZOO, ZIP, ARJ, LU, DWC, MD, HYPER, LHA, LHarc and LArc  files
  2511.            by itself (normal and SFX files).
  2512.  
  2513.            NoArchiveCredit runs BEFORE  the ULMultiply option  so before
  2514.            any added credits are calculated, FileDoor will first  reduce
  2515.            the base-credits for non-archived files.
  2516.  
  2517.  Example : NoArchiveCredit 50
  2518.            ─────────────────────────────────────────────────────────────
  2519.  Means   : If a non-archive file is uploaded, FileDoor will only count
  2520.            50% of the size as credits.
  2521.            ─────────────────────────────────────────────────────────────
  2522.  
  2523.  
  2524.  ┌─────────────────────────────────────────────────────────────────────┐
  2525.  │ Delete0ByteFiles                                                    │
  2526.  └─────────────────────────────────────────────────────────────────────┘
  2527.  Usage   : If this  option is used,  FileDoor will remove  all  UPLOADED
  2528.            files with  a length  of 0  bytes. The  user will be informed
  2529.            and the file is not counted as upload (ratio!).
  2530.  
  2531.  Example : Delete0ByteFiles
  2532.            ─────────────────────────────────────────────────────────────
  2533.  Means   : See description
  2534.            ─────────────────────────────────────────────────────────────
  2535.  
  2536.  
  2537.  ┌─────────────────────────────────────────────────────────────────────┐
  2538.  │ DelOldFiles [mm/dd/yy]                                              │
  2539.  └─────────────────────────────────────────────────────────────────────┘
  2540.  Usage   : If this  option is used,  FileDoor will remove  all  UPLOADED
  2541.            files that  have an  INTERNAL date  lower than  mm/dd/yy. The
  2542.            internal date is  calculated by looking  at all files  inside
  2543.            archives (if it is an  archive) and picking the highest  date
  2544.            inside the archive  as the date  to compare. For  non-archive
  2545.            files, FileDoor will look  at the normal date/time  stamp but
  2546.            that doesn't  always work  OK, because  some protocols  stamp
  2547.            the newly uploaded file with the date/time of today.
  2548.  
  2549.            [mm/dd/yy] must  be a  valid date  after which  files will be
  2550.                       deleted.
  2551.  
  2552.            The user will be notified  that the file will be  deleted and
  2553.            is not credited for the file.
  2554.  
  2555.  Example : DelOldFiles 01/01/90
  2556.            ─────────────────────────────────────────────────────────────
  2557.  Means   : Any file that is dated before 01/01/90 is removed from the
  2558.            upload and not counted. For archives, FileDoor will look
  2559.            inside the archive. The highest date inside the archive is
  2560.            matched with the date on DelOldFiles.
  2561.            ─────────────────────────────────────────────────────────────
  2562.  
  2563.  
  2564.  ┌─────────────────────────────────────────────────────────────────────┐
  2565.  │ DelAfterDl [mask]                                                   │
  2566.  └─────────────────────────────────────────────────────────────────────┘
  2567.  Usage   : This  is a  very tricky  option. There  can be  up to 100  of
  2568.            these options. If  a file is  downloaded that matches  [mask]
  2569.            on  one  (or  more)  of  the  DelAfterDL options, the file is
  2570.            DELETED after a successful download ! It is obvious that  you
  2571.            must  NOT   include  a   DelAfterDL  *.*   option  in    your
  2572.            FILEDOOR.CTL, otherwise all files inside your BBS areas  will
  2573.            eventually be deleted. Most obvious usage for this option  is
  2574.            to include file-masks that CAN be deleted like packages  from
  2575.            offline readers, DOWNLOAx.xxx (from DISP MTS.EXE) and so on.
  2576.  
  2577.            [mask] must be a  valid file-mask (wildcards are  allowed) of
  2578.                   a  file  that  can  be  deleted  after  a   successful
  2579.                   download.
  2580.  
  2581.  Example : DelAfterDL DOWNLOA*.*
  2582.            ─────────────────────────────────────────────────────────────
  2583.  Means   : All files which match the file-mask DOWNLOA*.* are deleted
  2584.            after one successful download.
  2585.            ─────────────────────────────────────────────────────────────
  2586.  
  2587.  
  2588.  ┌─────────────────────────────────────────────────────────────────────┐
  2589.  │ AlienArchive [extension]                                            │
  2590.  └─────────────────────────────────────────────────────────────────────┘
  2591.  Usage   : FileDoor has  a build-in knowledge of most normal  archivers.
  2592.            Some other files could also be archives but of the type  that
  2593.            FileDoor  does  not  know  internally.   BMP/TIF/PCX and such
  2594.            could be such files.
  2595.  
  2596.            You can  add up  to 10  AlienArchive options.  [Extension] is
  2597.            the extension  of these  special files.  FileDoor will  first
  2598.            look if the file is a normal archive and then take a look  at
  2599.            the AlienArchive  options to  see if  you have  included this
  2600.            file.  Please  add at least  'AlienArchive GIF' (if  you want
  2601.            the  to  be  counted  as  archives)  because  2.01a contained
  2602.            coding to see a GIF as  an archive but 2.02 does not  contain
  2603.            this coding anymore.
  2604.  
  2605.  Example : AlienArchive PCX
  2606.            ─────────────────────────────────────────────────────────────
  2607.  Means   : PCX files (*.PCX) are marked as archives.
  2608.            ─────────────────────────────────────────────────────────────
  2609.  
  2610.  
  2611.  ┌─────────────────────────────────────────────────────────────────────┐
  2612.  │ Ratio  [sec] [ratio] [K|F] [threshold]                              │
  2613.  └─────────────────────────────────────────────────────────────────────┘
  2614.  Usage    : You can  have FileDoor check  the current users  file ratios
  2615.            and allow him depending on  these figures to download or  not
  2616.            to let him  download files from  your system. Both  KiloBytes
  2617.            and number  of files  are allowed.  The first  option is  the
  2618.            user's  security  level,  the  second  the  ration  he   must
  2619.            maintain, the third one decides wether the amount of kB's  or
  2620.            the number of downloaded  files is tested. The  fourth option
  2621.            is  the  free  threshold  for  ratios.  FileDoor  will  allow
  2622.            downloads until the number set in the fourth parameter.  Only
  2623.            when this  number is  reached, Filedoor  will start  counting
  2624.            the  downloads,  with  the  files  downloaded during the free
  2625.            threshold counted in. Up to 100 ratios are allowed, but  only
  2626.            one per security level.
  2627.  
  2628.  
  2629.  Example : Ratio 100 10 F 20
  2630.            ─────────────────────────────────────────────────────────────
  2631.  Means   : Security level 100 must maintain a 1:10 file-number ratio but
  2632.            until the 20th file, the downloads are not checked against
  2633.            the ratio !
  2634.            ─────────────────────────────────────────────────────────────
  2635.  
  2636.  
  2637.  ┌─────────────────────────────────────────────────────────────────────┐
  2638.  │ PrivateUploads                                                      │
  2639.  └─────────────────────────────────────────────────────────────────────┘
  2640.  Usage   : If set the private  uploads (to the Sysop)  are allowed.  The
  2641.            description is placed in  a separate file, PFILES.BBS  in the
  2642.            upload directory.  The user has to start the  filedescription
  2643.            with a '/' to make an upload private.
  2644.  
  2645.  Example : PrivateUploads
  2646.            ─────────────────────────────────────────────────────────────
  2647.  Means   : See description
  2648.            ─────────────────────────────────────────────────────────────
  2649.  
  2650.  
  2651.  ┌─────────────────────────────────────────────────────────────────────┐
  2652.  │ TouchUploads                                                        │
  2653.  └─────────────────────────────────────────────────────────────────────┘
  2654.  Usage   : If  set all  uploads will  get the  date/time stamp  of  your
  2655.            system and not the  original date/time. This way  all uploads
  2656.            will be displayed as *NEW* files.
  2657.  
  2658.  Example : TouchUploads
  2659.            ─────────────────────────────────────────────────────────────
  2660.  Means   : See description
  2661.            ─────────────────────────────────────────────────────────────
  2662.  
  2663.  
  2664.  ┌─────────────────────────────────────────────────────────────────────┐
  2665.  │ ULMultiply [sec] [multbyte] [multtime]                              │
  2666.  └─────────────────────────────────────────────────────────────────────┘
  2667.  Usage   : This is a very  powerful option. With the  ULMultiply  option
  2668.            you can govern  the credit that  you will give  to your users
  2669.            when they  do uploads.  This can  even be  different for  the
  2670.            different security levels you use.
  2671.  
  2672.            [sec]      This  parameter must be set to the security  level
  2673.                       for which  the following  credits will  rule. Only
  2674.                       users with  this (exact)  security level  will get
  2675.                       the supplied credit when uploading files;
  2676.  
  2677.            [multbyte] This must be  a percentage ! This  percentage will
  2678.                       be the credit for users with security level  [sec]
  2679.                       that do uploads. The percentage is used to  credit
  2680.                       the number  of uploaded  BYTES !  Values less than
  2681.                       100 will  mean a  reduction and  values above  100
  2682.                       will mean a credit;
  2683.  
  2684.            [multtime] This must be  a percentage ! This  percentage will
  2685.                       be the credit for users with security level  [sec]
  2686.                       that do uploads. The percentage is used to  credit
  2687.                       the  number  of  minutes  the  user needed for the
  2688.                       upload (so it is a time-credit). Values above  100
  2689.                       will mean a credit,  values under 100 will  mean a
  2690.                       reduction;
  2691.  
  2692.            Normally the user  will be credited  for the time  the upload
  2693.            but this can be set to a higher value !
  2694.  
  2695.  Example : ULMultiply 100 200 400
  2696.            ─────────────────────────────────────────────────────────────
  2697.  Means    : All  users with  security level  100 will  get 200%  of  the
  2698.            uploaded  bytes  (so  uploaded  1000  bytes  will  result  in
  2699.            counting this as  2000 bytes) and  will also get  400% of the
  2700.            upload-time  (needed  2  minutes,  will  result  in 8 minutes
  2701.            credit,  so  8  minutes  minus  the original 2 minutes upload
  2702.            will come to a credit of 6 minutes).
  2703.            ─────────────────────────────────────────────────────────────
  2704.  
  2705.  
  2706.  ┌─────────────────────────────────────────────────────────────────────┐
  2707.  │ AskAnother                                                          │
  2708.  └─────────────────────────────────────────────────────────────────────┘
  2709.  Usage   : If set,  FileDoor will ask  the user if  he wants to  perform
  2710.            another file-transfer after completing a transfer.
  2711.  
  2712.  Example : AskAnother
  2713.            ─────────────────────────────────────────────────────────────
  2714.  Means   : See description
  2715.            ─────────────────────────────────────────────────────────────
  2716.  
  2717.  
  2718.  ┌─────────────────────────────────────────────────────────────────────┐
  2719.  │ TimeOut [amount] {HANG}                                             │
  2720.  └─────────────────────────────────────────────────────────────────────┘
  2721.  Usage   : This   will  set  the   number  seconds before FileDoor  will
  2722.            timeout a user  for inactivity. This  way you will  prevent a
  2723.            user to enter FileDoor and use all his BBS access time  doing
  2724.            nothing.   After  timing  out  a  user  he will be warned and
  2725.            eventually be returned to the BBS.
  2726.  
  2727.            [amount] must be the number of seconds that must pass  before
  2728.                     FileDoor  will  time-out  the  user.  There  will be
  2729.                     warnings before the actual time-amount;
  2730.  
  2731.            {HANG}   If  you   supply  HANG,  FileDoor will drop  the DTR
  2732.                     (thus the carrier)  at once. Without  HANG, FileDoor
  2733.                     will return to  the BBS first.  The BBS has  then to
  2734.                     decide if the user  must be disconnected (will  take
  2735.                     extra time);
  2736.  
  2737.  Example : TimeOut 180 HANG
  2738.            ─────────────────────────────────────────────────────────────
  2739.  Means   : After 3  minutes, FileDoor will disconnect the user  if there
  2740.            wasn't any activity during that period.
  2741.            ─────────────────────────────────────────────────────────────
  2742.  
  2743.  
  2744.  ┌─────────────────────────────────────────────────────────────────────┐
  2745.  │ NoLastChance                                                        │
  2746.  └─────────────────────────────────────────────────────────────────────┘
  2747.  Usage   : If   the  user  choses   to  disconnect  immediately after  a
  2748.            transfer  FileDoor  will  ask  the  user  to press any key to
  2749.            terminate  the  hang-up  process.  NoLastChance  will disable
  2750.            this feature.
  2751.  
  2752.  Example : NoLastChance
  2753.            ─────────────────────────────────────────────────────────────
  2754.  Means   : See description
  2755.            ─────────────────────────────────────────────────────────────
  2756.  
  2757.  
  2758.  ┌─────────────────────────────────────────────────────────────────────┐
  2759.  │ NoLogOff                                                            │
  2760.  └─────────────────────────────────────────────────────────────────────┘
  2761.  Usage   : When  you have  tuned FileDoor  in a  way that  the user  can
  2762.            restart FileDoor from within FileDoor (AskAnother option)  it
  2763.            could  be  handy  to  disallow  a logoff from within FileDoor
  2764.            (which is  normally available  when the  AskAnother option is
  2765.            set). You can  disallow any logoff  inside FileDoor when  you
  2766.            supply the optional NoLogOff option.
  2767.  
  2768.  Example : NoLogOff
  2769.            ─────────────────────────────────────────────────────────────
  2770.  Means   : See description
  2771.            ─────────────────────────────────────────────────────────────
  2772.  
  2773.  
  2774.  ┌─────────────────────────────────────────────────────────────────────┐
  2775.  │ MinSpace [amount]                                                   │
  2776.  └─────────────────────────────────────────────────────────────────────┘
  2777.  Usage   : With  this option  you will  be able  to set  the minimum  of
  2778.            disk-space that  must be  free for  allowing uploads  to your
  2779.            system.
  2780.  
  2781.            [amount] must  be set  in number  of KB's  of space that must
  2782.                     left to allow any upload.
  2783.  
  2784.            Bi-directional  protocols  (Bimodem/BiDSZ)  will  only case a
  2785.            display of the minimum space  but will allow uploads  anyhow.
  2786.            If  the  option  is  left  out,  no  compare  is made but the
  2787.            available space will be displayed only.
  2788.  
  2789.  Example : MinSpace 1000
  2790.            ─────────────────────────────────────────────────────────────
  2791.  Means   : At  least 1000Kb  must be  available on  the upload-drive  to
  2792.            allow any uploads.
  2793.            ─────────────────────────────────────────────────────────────
  2794.  
  2795.  
  2796.  ┌─────────────────────────────────────────────────────────────────────┐
  2797.  │ NoEMS                                                               │
  2798.  └─────────────────────────────────────────────────────────────────────┘
  2799.  Usage   : When this  option is available, FileDoor is forced  to ignore
  2800.            EMS for swapping space (if needed). If there is still XMS  or
  2801.            Extended Memory, FileDoor  will use this  type of memory.  If
  2802.            neither  of  these  two  resources  is available, FileDoor is
  2803.            forced to use disk-space. When  NoXMS is also present in  the
  2804.            FileDoor.CFG, disk-space is always used for swapping;
  2805.  
  2806.  Example : NoEms
  2807.            ─────────────────────────────────────────────────────────────
  2808.  Means   : See description
  2809.            ─────────────────────────────────────────────────────────────
  2810.  
  2811.  
  2812.  ┌─────────────────────────────────────────────────────────────────────┐
  2813.  │ NoXMS                                                               │
  2814.  └─────────────────────────────────────────────────────────────────────┘
  2815.  Usage   : When this  option is available, FileDoor is forced  to ignore
  2816.            XMS and Extended Memory for  swapping space (if needed).   If
  2817.            there is still  EMS, FileDoor will  use this type  of memory.
  2818.            If  EMS  is  not  available,   FileDoor  is  forced  to   use
  2819.            disk-space.  When NoEMS is also present in the  FileDoor.CFG,
  2820.            disk-space is always used for swapping;
  2821.  
  2822.  Example : NoXMS
  2823.            ─────────────────────────────────────────────────────────────
  2824.  Means   : See description
  2825.            ─────────────────────────────────────────────────────────────
  2826.  
  2827.  
  2828.  ┌─────────────────────────────────────────────────────────────────────┐
  2829.  │ DownloadHours [period] {baudrate}                                   │
  2830.  │ UploadHours   [period] {baudrate}                                   │
  2831.  └─────────────────────────────────────────────────────────────────────┘
  2832.  Usage   : These options can  be used to set periods in which  downloads
  2833.            and uploads  are possible  ( also  for specific  baud rates).
  2834.            You can  use a  number of  these options  (unlimited) to  set
  2835.            different  periods.  If  you  don't  use  either one of these
  2836.            options, the whole  24 hour is  counted as a  period in which
  2837.            there can be downloads and uploads.
  2838.  
  2839.            [period]   This  must be a block  of two times in  the format
  2840.                       hhmm-hhmm  (where  hh  is  the  hour  and  mm  the
  2841.                       minute)  separated  with  a  dash.  A  period must
  2842.                       NEVER extend midnight;
  2843.  
  2844.            {baudrate} This can be set  at the LOWEST baudrate for  which
  2845.                       this  period  will  govern.  If  no  {baudrate} is
  2846.                       given, 0 is  assumed (all connect  will be 0  baud
  2847.                       or higher so they can all enter the down/upload).
  2848.  
  2849.            An  extended  example.  You  want  to  have  the upload-hours
  2850.            between  18:00  and  02:00  and  the  download-hours run from
  2851.            16:00 until 18:00 for all users, from 18:00 to 21:00 for  all
  2852.            users with 2400  baud or higher  and from 21:00  to 02:00 for
  2853.            all users with  a 9600 baud  connect (or higher).   This will
  2854.            need the following options:
  2855.  
  2856.            UploadHours   1800-2359
  2857.            UploadHours   0000-0159
  2858.            DownloadHours 1600-1759
  2859.            DownloadHours 1800-2059 2400
  2860.            DownloadHours 2100-2359 9600
  2861.            DownloadHours 0000-0159 9600
  2862.  
  2863.            As you  can see,  all periods  needed are  covered. The  only
  2864.            thing  you  must  watch  is  not  to  run a period inside one
  2865.            option over midnight.
  2866.  
  2867.            If  a  period  is  closed  for download (or upload), FileDoor
  2868.            will  display  DNLDHRS.Axx  or  UPLDHRS.Axx (when available).
  2869.            When the connect is too slow for the period, TOOSLOWD.Axx  or
  2870.            TOOSLOWU.Axx  are  displayed  (when  present in the directory
  2871.            pointed to by the FileDoorDir option).
  2872.  
  2873.  Example : DownloadHours  0900-1200 9600
  2874.            ─────────────────────────────────────────────────────────────
  2875.  Means   : Open for  downloads between 0900-1200  and only for  9600  or
  2876.            higher  baudrates.  Uploads  can  be  done always. Your users
  2877.            will 'love' this setting.
  2878.            ─────────────────────────────────────────────────────────────
  2879.  
  2880.  
  2881.  ┌─────────────────────────────────────────────────────────────────────┐
  2882.  │ CheckDupes {sec}                                                    │
  2883.  └─────────────────────────────────────────────────────────────────────┘
  2884.  Usage   : If set, FileDoor will  perform a dupe-check (internally)   on
  2885.            the uploaded  files. All  dupes are  removed before  they are
  2886.            counted.  TRY.ZIP  is  considered  a  dupe  with  TRY.ARC but
  2887.            TRY.ARJ  is  NOT  considered  a  dupe  with  TRY.ALL. Archive
  2888.            extensions that will be tested  are ARC, PAK, PKA, LZH,  LZS,
  2889.            ZIP, ZOO, DWC, MD,  HYP, ARJ, SDN.   If this check is  to raw
  2890.            for your taste, you can insert  an exit (hook) in one of  the
  2891.            ExitAfterUpload  options.  The  called  file  will  then   be
  2892.            responsible to remove (and report) the duplicated files.
  2893.  
  2894.            {sec} is an optional security level. If it is set, all  users
  2895.                  with  that  level  (or  higher)  WON'T  get their files
  2896.                  checked for  duplicates. This  comes in  handy for your
  2897.                  CoSysop  or  other  users  who  are  allowed  to upload
  2898.                  duplicate files.
  2899.  
  2900.  Example : CheckDupes 10000
  2901.            ─────────────────────────────────────────────────────────────
  2902.  Means   : All users  up to security-level 9999 will have  their uploads
  2903.            checked for duplicates.
  2904.            ─────────────────────────────────────────────────────────────
  2905.  
  2906.  
  2907.  ┌─────────────────────────────────────────────────────────────────────┐
  2908.  │ TagFileMacro [dir]                                                  │
  2909.  └─────────────────────────────────────────────────────────────────────┘
  2910.  Usage   : This  version of  FileDoor allows  third party  utilities  to
  2911.            supply a tag file to  FileDoor.  This way programmers  have a
  2912.            way  to  pass  on  a  list  of  selected  files  to FileDoor.
  2913.            FileDoor will detect the tag  files from RFW (c) and  MTS (c)
  2914.            automatically.    The   structure   of   this   FileDoor/DISP
  2915.            compatible tag-file is present in the release-archive.
  2916.  
  2917.            [dir] must point to  the common location where  the tag-files
  2918.                  are placed.  MTS and  RFW (DISP  products) have options
  2919.                  to  point  to  that  directory.  The  file-name will be
  2920.                  created by FileDoor itself.
  2921.  
  2922.            Please read the  chapter on tagging  for more details  on the
  2923.            FileDoor/DISP-compatible tag-file.
  2924.  
  2925.  Example : TagFileMacro D:\BBS\RA
  2926.            ─────────────────────────────────────────────────────────────
  2927.  Means   : Tag-files will reside in  D:\BBS\RA and will be  loaded  from
  2928.            that location (if available).
  2929.            ─────────────────────────────────────────────────────────────
  2930.  
  2931.  
  2932.  ┌─────────────────────────────────────────────────────────────────────┐
  2933.  │ NewFileMacro [seclevel] {auto_display} {ask_areas}                  │
  2934.  └─────────────────────────────────────────────────────────────────────┘
  2935.  Usage   : If  this option  is enabled  FileDoor will  allow your  users
  2936.            with a security  level of [seclevel]  (and higher) to  easily
  2937.            detect, select and download NEW files since their last  logon
  2938.            to your system.
  2939.  
  2940.            [seclevel]     must  be   the  security-level from  which  on
  2941.                           users  can  use  /NEW  while  inside  FileDoor
  2942.                           <tm>;
  2943.  
  2944.            {auto_display} If set to 'Y' (no quotes), FileDoor will  show
  2945.                           the tag  at startup.  In this  case, users are
  2946.                           reminded  at  once  that  they  can  use  /NEW
  2947.                           otherwise they  should obtain  their knowledge
  2948.                           from  the  help-screen.  If  you don't want to
  2949.                           display the tag at once but you need the  next
  2950.                           parameter,  you  must  code  a  'N'  for  this
  2951.                           parameter;
  2952.  
  2953.            {ask_areas}    If  set to  'Y' (no  quotes and  the  previous
  2954.                           parameter must  be set),  users are  asked for
  2955.                           EACH eligible area  if FileDoor should  search
  2956.                           that area for new files;
  2957.  
  2958.  Example : NewFileMacro 100 N Y
  2959.            ─────────────────────────────────────────────────────────────
  2960.  Means   : Users  with security  level 100  (and higher)  will have  the
  2961.            option to use the /NEW  macro. This will be displayed  at the
  2962.            startup of FileDoor.
  2963.            ─────────────────────────────────────────────────────────────
  2964.  
  2965.  
  2966.  ┌─────────────────────────────────────────────────────────────────────┐
  2967.  │ NoShowInternalMacros                                                │
  2968.  └─────────────────────────────────────────────────────────────────────┘
  2969.  Usage   : Normally FileDoor will show the user all available macros  at
  2970.            startup.  These  include  the  external  (UserMacro),  pseudo
  2971.            external (NewFileMacro) and internal (/USER, /UDEL, /TAG  and
  2972.            so on) macros.
  2973.  
  2974.            If you set this option,  FileDoor will not show the  internal
  2975.            macro's at startup. The  user must access the  help-screen to
  2976.            show the available (internal) macros.
  2977.  
  2978.            With this  option set  and the  possibility to  select if you
  2979.            want to  show external  and pseudo-external  macro's you  can
  2980.            decide if you want to show  all, some or none of the  macro's
  2981.            at startup.
  2982.  
  2983.  Example : NoShowInternalMacros
  2984.            ─────────────────────────────────────────────────────────────
  2985.  Means   : See description
  2986.            ─────────────────────────────────────────────────────────────
  2987.  
  2988.  
  2989.  ┌─────────────────────────────────────────────────────────────────────┐
  2990.  │ UserMacro [tag] [auto] [desc] [mask] {sec}                          │
  2991.  └─────────────────────────────────────────────────────────────────────┘
  2992.  Usage   : This   option  allows  a   user  to  use external  macros. An
  2993.            external macro is a simple name for a certain file. Lets  say
  2994.            that your allfiles-file is  called AF512100.ZIP, you can  now
  2995.            create a macro (also called  tag) with the name ALLFILE  that
  2996.            points to this file.  The only thing the  user has to do,  is
  2997.            to supply /ALLFILE on the file-selection menu. FileDoor  will
  2998.            start  a   search  for   AF512100.ZIP  and   the  user    can
  2999.            (optionally) select the file for download.
  3000.  
  3001.            [tag]  is  the name you  want to use  for the macro.  Up to 8
  3002.                   digits are allowed;
  3003.  
  3004.            [auto] can be set  to either 'Y' or  'N' (no quotes). If  set
  3005.                   to  'Y',  FileDoor  will  display  this macro (tag) at
  3006.                   startup, otherwise the user must obtain the name  from
  3007.                   the help-screen;
  3008.  
  3009.            [desc] is  a  short  (32  bytes  or less) description of  the
  3010.                   macro. Any spaces in the description must be codes  as
  3011.                   underscores.  FileDoor  will  replace  the underscores
  3012.                   with spaces when displaying the description;
  3013.  
  3014.            [mask] points to the file  (or filemask) that is meant  to be
  3015.                   downloaded.  When  you  use  a  simple  filename  or a
  3016.                   filemask (?,  *), FileDoor  will start  a search party
  3017.                   for the file(s). When  you include a drive,  directory
  3018.                   and filename  (no wildcards),  you can  even point  to
  3019.                   files outside the normal BBS areas.
  3020.  
  3021.            {sec}  This  optional  parameter  can  be  set to the  lowest
  3022.                   security-level that is allowed to use this macro.
  3023.  
  3024.  
  3025.  Example : UserMacro MTA Y The_newest_MTA_Package MTA_V???.??? 20
  3026.            ─────────────────────────────────────────────────────────────
  3027.  Means   : The user  with security level  20 or higher  can use /MTA  to
  3028.            obtain the  latest MTA-package.  The macro  will be displayed
  3029.            at startup.
  3030.            ─────────────────────────────────────────────────────────────
  3031.  
  3032.  
  3033.  ┌─────────────────────────────────────────────────────────────────────┐
  3034.  │ SysopPassword [password] [sec]                                      │
  3035.  └─────────────────────────────────────────────────────────────────────┘
  3036.  Usage   : If a users  enters // in the file-selection menu she/he  will
  3037.            be presented with  the new questions:   'Enter password'  and
  3038.            'Give full path  and filename of  the wanted file'.  This way
  3039.            the cosysop  or every  other user  you give  knowledge of the
  3040.            password  and  has  the  right  security,  will  be  able  to
  3041.            download  from  every  directory  on  your system if hers/his
  3042.            sec.level is the same or higher than a given level.
  3043.  
  3044.            [password] can   be up   to 20   characters without   spaces.
  3045.                       The case is not important.
  3046.  
  3047.            [sec]      must  be set to  the security level  at which  you
  3048.                       allow the usage of the // macro;
  3049.  
  3050.            The user   must enter   a filename   (full) and    (optional,
  3051.            when the file  is not in  the current directory)  a full path
  3052.            to  the  file  (including   drive  when   the  directory   is
  3053.            not on the current drive).  Only one  file at  the time   can
  3054.            be selected (no   wildcards  allowed)   but  //   can be used
  3055.            multiple times before the actual download has to start.
  3056.  
  3057.            There is  no   other check  whatsoever to   the selected file
  3058.            and your complete system is open for download.
  3059.  
  3060.  Example : SysopPassword MySecretPwd 10000
  3061.            ─────────────────────────────────────────────────────────────
  3062.  Means   : Users  who know  the password  MySecretPwd can  access  files
  3063.            they can  normally not  obtain (USERS.BBS,  be warned  !!) if
  3064.            they have security-level 10000 or higher !
  3065.            ─────────────────────────────────────────────────────────────
  3066.  
  3067.  
  3068.  ┌─────────────────────────────────────────────────────────────────────┐
  3069.  │ PasswordProtect [mask] [password]                                   │
  3070.  └─────────────────────────────────────────────────────────────────────┘
  3071.  Usage   : Up to 100 PasswordProtect  options can be included.  You  can
  3072.            use this option to protect files with passwords. When a  user
  3073.            selects  a  file  with  a  password,  she/he has 3 chances to
  3074.            supply the password. After the  3th try the user is  returned
  3075.            to the file-selection.
  3076.  
  3077.            [mask]     must be a filename  or filemask (with   wildcards)
  3078.                       that you want to protect;
  3079.  
  3080.            [password] is  the password  that is  assigned to  [mask]. It
  3081.                       can be up to 8 characters and case will always  be
  3082.                       converted to uppercase;
  3083.  
  3084.  Example : PasswordProtect QEM*.* DISPAWARE
  3085.            ─────────────────────────────────────────────────────────────
  3086.  Means   : If a user wants to download a file that matches mask  QEM*.*,
  3087.            a password (DISPAWARE) must be given !
  3088.            ─────────────────────────────────────────────────────────────
  3089.  
  3090.  
  3091.  ┌─────────────────────────────────────────────────────────────────────┐
  3092.  │ LockPassword  [password] {STARTUP}                                  │
  3093.  └─────────────────────────────────────────────────────────────────────┘
  3094.  Usage   : You  can lock  FileDoor from  the local  side. This comes  in
  3095.            handy  when  you  don't  want  to  allow  anyone (from Kat to
  3096.            Child) to  press any  key inside  FileDoor when  you are  not
  3097.            looking. ALT-L will do the trick and ALT-X will put  FileDoor
  3098.            back  in  'accepting-mode'.  ALT-L  and  ALT-X will only work
  3099.            when you supply a password with this option.
  3100.  
  3101.            [password] is a  password that is  needed after pressing  the
  3102.                       ALT-X key;
  3103.  
  3104.            {STARTUP}  If you  code STARTUP (optional), FileDoor  will be
  3105.                       in locked mode at startup;
  3106.  
  3107.  Example:  LockPassword NoKats STARTUP
  3108.            ─────────────────────────────────────────────────────────────
  3109.  Means   : If FileDoor starts, the keyboard is locked and the Sysop must
  3110.            supply ALT-U with password NoKats to unlock the keyboard.
  3111.            ─────────────────────────────────────────────────────────────
  3112.  
  3113.  
  3114.  ┌─────────────────────────────────────────────────────────────────────┐
  3115.  │ ExitAfterSelect   [program] [options]                               │
  3116.  └─────────────────────────────────────────────────────────────────────┘
  3117.  Usage   : This exit  is called after  EVERY 'Y' on  a file-select  with
  3118.            download. If  the called  program returns  errorlevel 0,  the
  3119.            file  is  allowed,  if  the  errorlevel  is  1 or higher, the
  3120.            selection  is  denied  even  after  FileDoor  has  allowed it
  3121.            before.
  3122.  
  3123.            [program] must point to the program you want to call and must
  3124.                      include drive, directory and full program name;
  3125.  
  3126.            [options] must  be  the   command-line  for  the    specified
  3127.                      program.    You   can   include   multiple   macros
  3128.                      (described later) to be replaced by FileDoor.
  3129.  
  3130.  Example : ExitAfterSelect C:\UTILS\CALCUSER.EXE $C $B $U
  3131.            ─────────────────────────────────────────────────────────────
  3132.  Means   : After each selection (for download), CALCUSER.EXE is called.
  3133.            ─────────────────────────────────────────────────────────────
  3134.  
  3135.  
  3136.  ┌─────────────────────────────────────────────────────────────────────┐
  3137.  │ ExitAfterDownload Drive:\Path\Filename.Ext [options]                │
  3138.  └─────────────────────────────────────────────────────────────────────┘
  3139.  Usage   : This exit is called  after the download (successful  or  not)
  3140.            and for EVERY  file that was  selected.  In  combination with
  3141.            the ExitAfterSelect  you can  decide to  do something  to the
  3142.            selected files (for example, add a file or comment with  your
  3143.            compress-program)  in  the  ExitAfterSelect  and reverse this
  3144.            action on the ExitAfterDownload  option to reset the  file to
  3145.            its original state. The problem of file sharing is up to  the
  3146.            program that is called in the exit.
  3147.  
  3148.            In a later version, special options will be available to  add
  3149.            files  and/or  comments  to  archives before the transmission
  3150.            and  remove  them  afterwards  but  until  then this could be
  3151.            something for you !
  3152.  
  3153.            [options]  must  be  the   command-line  for  the   specified
  3154.            program.  You can  include multiple macros (described  later)
  3155.            to be replaced by FileDoor.
  3156.  
  3157.  Example : ExitAfterDownload C:\UTILS\CALCUSER.EXE $C $B $U
  3158.            ─────────────────────────────────────────────────────────────
  3159.  Means   : After the actual download, CALCUSER.EXE is called to perform
  3160.            'its thing'.
  3161.            ─────────────────────────────────────────────────────────────
  3162.  
  3163.  
  3164.  ┌─────────────────────────────────────────────────────────────────────┐
  3165.  │ ExitAfterUpload1 Drive:\Path\Filename.Ext [options]                 │
  3166.  │ ExitAfterUpload2 Drive:\Path\Filename.Ext [options]                 │
  3167.  │ ExitAfterUpload3 Drive:\Path\Filename.Ext [options]                 │
  3168.  └─────────────────────────────────────────────────────────────────────┘
  3169.  Usage   : These exits are called after the upload. You can implement  3
  3170.            of them. The exits are on their own. The fossil is closed  by
  3171.            FileDoor and parameters are passed to the called program.
  3172.  
  3173.            [options] are the same  as with the previous  ExitAfterSelect
  3174.                      options.  The  command-line   parameters  for   the
  3175.                      called  program  can  also  include macros that are
  3176.                      replaced by FileDoor.
  3177.  
  3178.            The following  macros are  available to  be implemented  into
  3179.            the command-line [options] of the called program:
  3180.  
  3181.            - $C will be replaced with the Com-port number
  3182.            - $B   ,, ,,    ,,     ,,   ,, Baud-rate
  3183.            - $T   ,, ,,    ,,     ,,   ,, time-left to the user
  3184.            - $S   ,, ,,    ,,     ,,   ,, allowed download-limit
  3185.            - $Z   ,, ,,    ,,     ,,   ,, DSZLOG env. variable
  3186.            - $U   ,, ,,    ,,     ,,   ,, upload-path
  3187.            - $F   ,, ,,    ,,     ,,   ,, filename (ExitAfterSelect)
  3188.            - $D   ,, ,,    ,,     ,,   ,, path to EXITINFO/DORINFO1
  3189.            - $M   ,, ,,    ,,     ,,   ,, swap before exit is called
  3190.            - $N if this option is present, the exit is ONLY called
  3191.                 when there are actual uploaded files;
  3192.  
  3193.            A  special  note  on  the  ExitAfterUploadx  exits.  A called
  3194.            program  can  copy  a  file  with  the  same  name  but  with
  3195.            extension F$D  into the  upload-directory. When  this is  the
  3196.            case,  a  special  routine  will  be triggered. FileDoor will
  3197.            obtain the size of the original file from this file and  will
  3198.            NOT take  the actual  size. This  routine is  created so that
  3199.            recompression (not recommended !!) can be done inside one  of
  3200.            the exits while  FileDoor can still  credit the user  for the
  3201.            actual number of bytes that were uploaded. One  recompression
  3202.            program that  can do  this job  is MTA  (version 15.xx)  with
  3203.            it's /STOSIZ option.
  3204.  
  3205.  Example : ExitAfterUpload1 C:\UTILS\ZIPZOOM.EXE $C $B $U
  3206.            ─────────────────────────────────────────────────────────────
  3207.  Means   : After the actual upload, ZIPZOOM.EXE is called. Some macros
  3208.            will be expanded.
  3209.            ─────────────────────────────────────────────────────────────
  3210.  
  3211.  
  3212.  ┌─────────────────────────────────────────────────────────────────────┐
  3213.  │ ExitMasks [exit] [mask] {mask}..{mask}                              │
  3214.  └─────────────────────────────────────────────────────────────────────┘
  3215.  Usage   : Normally  the   three  ExitafterUpload1/2/3 exits  will  exit
  3216.            after every  upload. This  can be  a waste  of time  when the
  3217.            exit will only test files with specific extensions like  GIF.
  3218.            For these cases you can include the ExitMasks option. If  you
  3219.            don't include  the ExitMasks  option(s), the  exits will work
  3220.            for all files.
  3221.  
  3222.            [exit] must have the value U1,  U2 or U3 to tell FileDoor  is
  3223.                   this option is meant for the ExitAfterUpload1, 2 or  3
  3224.                   exit.
  3225.  
  3226.            [mask] must  be a  valid file-mask  (wildcards can  be used).
  3227.                   You must supply at least  one mask but you can  supply
  3228.                   up to 5 masks on every ExitMasks option.
  3229.  
  3230.            When, for a specific  exit, you include the  ExitMasks option
  3231.            as well, the exit will ONLY be called when there is at  least
  3232.            one  file  uploaded  that  matches  [mask]  in  the ExitMasks
  3233.            option for that exit.
  3234.  
  3235.  Example : ExitMasks U1 *.GIF *.JPG
  3236.            ─────────────────────────────────────────────────────────────
  3237.  Means   : The ExitAfterUpload1 exit will be called ONLY when there  are
  3238.            files uploaded which match *.GIF or *.JPG
  3239.            ─────────────────────────────────────────────────────────────
  3240.  
  3241.  
  3242.  ┌─────────────────────────────────────────────────────────────────────┐
  3243.  │ AddFile [path] {only_bi}                                            │
  3244.  └─────────────────────────────────────────────────────────────────────┘
  3245.  Usage   : You can add up to 10 AddFile options. All files you supply
  3246.            by means of AddFile options (each AddFile option must point
  3247.            to a full drive, directory and filename) will be added to
  3248.            the list of downloads (if there is still space to do so).
  3249.  
  3250.            [path]    must point to a  file that you want  to send  along
  3251.                      with the selected files that will be downloaded.
  3252.  
  3253.            {only_bi} is optional  and, when used,  must have a  value of
  3254.                      'Y' (without  the quotes).  In this  case, the file
  3255.                      pointed to  by [path]  will only  be send  when the
  3256.                      protocol is one of the bi-directional type.
  3257.  
  3258.            If you love your users,  you can think about sending  a small
  3259.            advertisement file  (1K or  less) instead  of adding comments
  3260.            (uncompressed) to all  your files. Why  bother the user  with
  3261.            the  same  advertisement  over  and  over. Other sysop's that
  3262.            download your files  will use a  program like MTA  <tm> (DISP
  3263.            program)  to  strip  the  comments  right after receiving the
  3264.            file.
  3265.  
  3266.  Example : AddFile C:\USERS\ADVERTIS.ZIP
  3267.            ─────────────────────────────────────────────────────────────
  3268.  Means   : When the user starts the download (batch protocols only), the
  3269.            file ADVERTIS.ZIP is added to the list of files to download.
  3270.            ─────────────────────────────────────────────────────────────
  3271.  
  3272.  
  3273.  3.3.7 Filedoor's Protocol Definition
  3274.  ───────────────────────────────────────────────────────────────────────
  3275.  This will be the  toughest part of the  Filedoor.Cfg. In this part  you
  3276.  will  be  shown  how  to  install  external  protocols  in FileDoor. An
  3277.  example with almost every known external protocol has been included  in
  3278.  the package.
  3279.  
  3280.  We  strongly  urge  all  filedoor  users  to  share their knowledge and
  3281.  experience with other  and new protocols  in FileDoor with  the author.
  3282.  This way we are able to  update the examples and help users  installing
  3283.  these  protocols  in  FileDoor.  Please  sent  your  information to the
  3284.  author  by  Net  or  SnailMail  or  use the international echomail area
  3285.  DISP.
  3286.  
  3287.  Each protocol definition is made up  by (at least) 2 or 3  options that
  3288.  must  be  coded   after  each  other.   FileDoor  will  check   if  the
  3289.  combinations  you  made  are  OK.  For  every  protocol  AND  for every
  3290.  direction of that protocol (upload  and download) you want to  include,
  3291.  you must create a  'set' of these 2  or 3 command. The  following order
  3292.  is mandatory:
  3293.  
  3294.  - PROTOCOL
  3295.    This one comes first
  3296.  
  3297.  - USAGE
  3298.    This one is optional, but, if present, must follow PROTOCOL
  3299.  
  3300.  - [prot-call]
  3301.    This one is mandatory and must follow either PROTOCOL (in which  case
  3302.    you don't have a USAGE for this protocol/direction) or USAGE;
  3303.  
  3304.  When FileDoor starts,  it will take  the eligible protocols,  depending
  3305.  upon the direction (triggered by  -DD for download or -DU  for upload),
  3306.  the  baudrate  and  the  security  and  will  store them in memory. The
  3307.  number of  protocols is  only limited  by the  maximum number  of lines
  3308.  that can  fit one  screen (without  a scroll)  and should  be enough to
  3309.  give the user a wide selection of possible protocols.
  3310.  
  3311.  Be very careful  when you implement  the protocols. Unexpected  results
  3312.  are almost  impossible (FileDoor  will give  error messages)  but it is
  3313.  advised to run FileDoor locally a few times to test all the protocols.
  3314.  
  3315.  
  3316.  ┌─────────────────────────────────────────────────────────────────────┐
  3317.  │ Protocol [effic] [letter] [direction] [maxfile] [MinBaud] [Text]    │
  3318.  └─────────────────────────────────────────────────────────────────────┘
  3319.  This  is  the  first  line  that  will  make  up  a  complete  protocol
  3320.  description  for  a  certain  direction.  The  PROTOCOL  option must be
  3321.  completed  with  at  least  a  [prot-call]  option and (optionally) the
  3322.  USAGE option.
  3323.  
  3324.  If you want to implement a  protocol (f.i. Zmodem) for both upload  and
  3325.  download, you  need 2  sets of  PROTOCOL/USAGE/[prot-call] options. One
  3326.  for the 'direction' download and one for the 'direction' upload !
  3327.  
  3328.  [effic]     This must  be the efficiency-rate of the protocol (it  is a
  3329.              percentage). When you  don't have a  clue about this  rate,
  3330.              you should take the supplied rates in the example file.  In
  3331.              short, if the efficiency  is 100%, the protocol  can manage
  3332.              to send  the bytes  without overhead.  Most protocols  have
  3333.              some overhead  (ACK/NAK, CRC's  and so  on) and  their rate
  3334.              will  not  go  over  95%.  Some special protocols (and some
  3335.              special connections, like  MNP5/LAPM connections) are  able
  3336.              to raise the efficiency to 100% !
  3337.  
  3338.              FileDoor uses the efficiency in 2 ways:
  3339.  
  3340.              - When  the user  selects a  file, FileDoor  will calculate
  3341.                the  transfer-time,  based  on   the  baudrate  and   the
  3342.                efficiency. A low  efficiency will cause  the calculation
  3343.                to  be  lower,  a  high  efficiency  will  cause it to be
  3344.                higher. If you choose the efficiency too low, it will  be
  3345.                possible that  some users  select a  file but  will get a
  3346.                deny  message  because   FileDoor  calculated  that   the
  3347.                transfer  would  take  to  long.  The reversed can happen
  3348.                with an efficiency-rate that  is too high. In  this case,
  3349.                the users would be able  to select files without a  deny,
  3350.                while the actual transfer will take longer that the  time
  3351.                calculated by FileDoor;
  3352.  
  3353.              - When using 'OTHER'  types of protocols (see  [prot-call])
  3354.                FileDoor will assume a good transfer (download) when  the
  3355.                time needed  for the  transfer is  the same  as the  time
  3356.                calculated by FileDoor  (there is a  10% margin). If  the
  3357.                rates  are  too  low,  FileDoor  could  assume  that  the
  3358.                transfer was  not OK,  because the  actual transfer  took
  3359.                less time than the time calculated by FileDoor;
  3360.  
  3361.              In  general,  if  you  don't  know  the efficiency, use the
  3362.              supplied examples  or do  some experiments  yourself to see
  3363.              what is best;
  3364.  
  3365.  [letter]    Each protocol is  marked with a letter that can be  used by
  3366.              the user when the  protocol-menu is presented. The  letters
  3367.              can be the same for  different directions, so you can  have
  3368.              a 'Z' (for Zmodem) for download and a 'Z' (for Zmodem)  for
  3369.              upload, but you can't  have the same letters  for different
  3370.              protocols  for  a  given  direction  (so  'Z'  for   Zmodem
  3371.              download  and  'Z'  for   SZModem  download  is   invalid).
  3372.              FileDoor  will  check  for   duplicate  letters  and   will
  3373.              terminate. All letters from A-Z and all digits between  0-9
  3374.              are  allowed  UNLESS   you  used  one   or  two  of   these
  3375.              letters/digits  as  the  exit/help  keys.  The  case of the
  3376.              letter is not important;
  3377.  
  3378.  [direction] You must supply  either a 'D' for  download or 'U' for  the
  3379.              upload.  The  'B'  that  was  used  in previous versions of
  3380.              FileDoor (2.xx) is now  obsolete and should be  replaced by
  3381.              two new sets  (one set with  a 'D' and  one set with  'U').
  3382.              All PROTOCOL options with a 'D' are selected when  FileDoor
  3383.              is  called  with  the  -DD  command-line  parameter and all
  3384.              PROTOCOL options with a  'U' are selected when  FileDoor is
  3385.              called with the -DU command-line parameter;
  3386.  
  3387.  [Maxfile]   Over here you must supply the maximum number of files  that
  3388.              can be transferred by this protocol in ONE session (from  1
  3389.              to  255).  Batch-protocols  can  have  numbers above 1, old
  3390.              protocols (OPUS types and  Xmodem/YModem) must work with  a
  3391.              value of 1. FileDoor will stop the selection of files  when
  3392.              the  number   of  already   selected  files   has   reached
  3393.              [maxfile];
  3394.  
  3395.  [Minbaud]   This option is still present for historical reasons. It  is
  3396.              duplicated in the USAGE option  but is also kept over  here
  3397.              so users of earlier versions of FileDoor can still use  the
  3398.              old PROTOCOL definitions. See  USAGE for a description.  If
  3399.              there are values  in both the  PROTOCOL and USAGE  options,
  3400.              the one in  the USAGE option  will overrule the  one in the
  3401.              PROTOCOL option;
  3402.  
  3403.  [Text]      Over here you supply a text for the given  protocol-letter.
  3404.              You can supply up to 30 characters of text;
  3405.  
  3406.  
  3407.  ┌─────────────────────────────────────────────────────────────────────┐
  3408.  │  Usage [minbaud] [sec] [arq] [win] [maxbaud]                        │
  3409.  └─────────────────────────────────────────────────────────────────────┘
  3410.  The  USAGE  option  can  be  used  to  set  some  internal and security
  3411.  options.   USAGE is  optional but  when it  is present,  it must be put
  3412.  between the PROTOCOL and [prot-call] options.
  3413.  
  3414.  [Minbaud]   This option  can have  a value  from 0  to 999999.  It   is
  3415.              matched  with  the  baudrate  of  the  user.  If  the users
  3416.              baudrate is equal to or higher than [minbaud] the  protocol
  3417.              will be available for the user, otherwise it is not  shown,
  3418.              nor can it be selected;
  3419.  
  3420.  [sec]       This  option can   have a  value from  0 to  65535. It   is
  3421.              matched with the security level  of the user. If the  users
  3422.              security  level  is  equal  to  or  higher  than  [sec] the
  3423.              protocol will be  available for the  user, otherwise it  is
  3424.              not shown, nor can it be selected;
  3425.  
  3426.  [arq]       This option can have a value of 'Y' or 'N'. You should  use
  3427.              a 'Y' (without  the quotes) for  those protocols that  will
  3428.              only work  with modem-connects  that have  their own  error
  3429.              correction (a NMP-connect or ARQ-connect, mostly used  with
  3430.              highspeed modems). At  present, FileDoor does  NOTHING with
  3431.              the value, but 3.10 will add the logic;
  3432.  
  3433.  [win]       FileDoor has 4 different  spawn (shell) routines that   can
  3434.              be used when calling a protocol program. These are:
  3435.  
  3436.              - Shell while swapping FileDoor from memory, full screen;
  3437.              - Shell (without swap), full screen;
  3438.              - Shell while swapping FileDoor from memory, windowed
  3439.                screen;
  3440.              - Shell (without swap), windowed screen;
  3441.  
  3442.              The [win] parameter can  be set to 'N'  (full-screen shell)
  3443.              or 'Y'  (windowed-screen shell).  If you  select a windowed
  3444.              shell, FileDoor will  try to keep  the last 4  lines of the
  3445.              screen  to  itself  (an  extended  status-bar),  otherwise,
  3446.              FileDoor will write a (unprotected) status-line on line  25
  3447.              but it  can be  overwritten by  the protocol.  Some of  the
  3448.              protocols  (Bimodem,  Puma,  Zyrion  and  such) need a full
  3449.              screen, some of them can be installed to work in a  smaller
  3450.              window (GSZ) and some can be fully windowed (all  line-type
  3451.              protocols like DSZ).  On some machines  or with some  cache
  3452.              type of programs (older caches), the windowed screen  won't
  3453.              work, in which  case you must  use the normal  full-screen.
  3454.              If  you  don't  use  a  USAGE  parameter, the protocol will
  3455.              always run in a full-screen;
  3456.  
  3457.  [Maxbaud]   This option  can have  a value  from 0  to 999999.  It   is
  3458.              matched  with  the  baudrate  of  the  user.  If  the users
  3459.              baudrate is equal to  or lower than [maxbaud]  the protocol
  3460.              will be available for the user, otherwise it is not  shown,
  3461.              nor  can  it  be  selected.  If  the parameter is left out,
  3462.              FileDoor will assign a default of 9999999 so all  baudrates
  3463.              can use this protocol if also [Minbaud] is validated;
  3464.  
  3465.  
  3466.  ┌─────────────────────────────────────────────────────────────────────┐
  3467.  │ [prot-call] [protocol] [options]                                    │
  3468.  └─────────────────────────────────────────────────────────────────────┘
  3469.  This  option  MUST  follow  either  after  a PROTOCOL option or a USAGE
  3470.  option. It is used to tell FileDoor about the protocol in question  and
  3471.  is the last of the 2 (3) options that make a full protocol  definition.
  3472.  There are  several types  of [prot-call]  options, [prot-call]  is only
  3473.  used in this  documentation to assign  the whole group  of options that
  3474.  can be used.  The only thing  you must keep  in mind is  that there can
  3475.  only be ONE of such options after the PROTOCOL or USAGE option !
  3476.  
  3477.  [prot-call] The following values (options) can be used:
  3478.  
  3479.              DSZ        : This option tells FileDoor that this type   of
  3480.                           protocol uses the  DSZ rules. That  means that
  3481.                           the  protocol  writes  log-records  in the log
  3482.                           that  is  assigned  by  the DSZLOG environment
  3483.                           variable  and  that  these  log-records follow
  3484.                           the  same  rules.  Obvious,  programs like DSZ
  3485.                           and GSZ (by  Omen) are DSZ-types.  SZModem can
  3486.                           also  be  setup  as  a  DSZ-type  of protocol.
  3487.                           FileDoor  will   obtain   download-information
  3488.                           from  the  DSZ-alike  log-file,  so it is most
  3489.                           important  that  the   protocol  follows   the
  3490.                           rules, otherwise  the downloads  could not  be
  3491.                           counted or counted wrong !
  3492.  
  3493.              BIDSZ      : This option tells FileDoor that this type   of
  3494.                           protocol  uses  the  DSZ-alike  syntax  (so  a
  3495.                           DSZ-log  with  that  type  of records) but can
  3496.                           work  as  a  bi-directional  protocol.  At the
  3497.                           moment only HSLink  can (must) be  implemented
  3498.                           as such  a protocol.  The user  will have  the
  3499.                           option to  supply BOTH  uploads and  downloads
  3500.                           (see BIMODEM type);
  3501.  
  3502.              BIMODEM    : This option tells FileDoor that  the  protocol
  3503.                           works as Bimodem  <tm> and uses  a BIMODEM.CFG
  3504.                           and a Bimodem-alike log-file. At this  moment,
  3505.                           only  Bimodem  itself  can  be  assigned  as a
  3506.                           BIMODEM type of protocol (obvious). When  this
  3507.                           type of  protocol is  used, FileDoor  will ask
  3508.                           for  both  uploads  AND  downloads. If you use
  3509.                           -DD FileDoor will first ask for downloads,  if
  3510.                           you  use  -DU,  FileDoor  will  first  ask for
  3511.                           uploads.   In either  case the  user does  not
  3512.                           need  to   enter  a   single  file,    because
  3513.                           Bimodem-alike protocols can use a special  way
  3514.                           of   download/upload   (by    means   of    an
  3515.                           Bimodem-internal communication file);
  3516.  
  3517.              OPUS       : This option tells FileDoor that this  type  of
  3518.                           protocol uses the OPUS 1.xx conventions.  Some
  3519.                           of these protocols  are MegaLink, OKermit  and
  3520.                           CLink. All  of them  read a  special file that
  3521.                           will be  created by  FileDoor and  all of them
  3522.                           write a special file  that will be re-read  by
  3523.                           FileDoor to see if the transfers were ok;
  3524.  
  3525.              ERRORLEVEL : This option  tells FileDoor that this  type of
  3526.                           protocol returns a non-zero errorlevel if  the
  3527.                           transfer  was  not  OK  and  that it is also a
  3528.                           protocol  that  can  not  be  assigned  as   a
  3529.                           DSZ-type or OPUS-type of protocol. You  should
  3530.                           always set the maximum  number of files to  be
  3531.                           transmitted  in  one  run  to 1 (never higher)
  3532.                           because   when   FileDoor   gets   a  non-zero
  3533.                           errorlevel with more  than one file,  FileDoor
  3534.                           can not know  which files were  transmitted OK
  3535.                           and  which  didn't.  In  those cases ALL files
  3536.                           are marked as  'not-transmitted' and also  not
  3537.                           counted;
  3538.  
  3539.              OTHER      : If none of the above options can be used,  you
  3540.                           must a type of OTHER to the protocol. In  this
  3541.                           case,  FileDoor  will  calculate  how long the
  3542.                           transfer will take  (in seconds and  minutes).
  3543.                           If it took that amount of time (or longer,  or
  3544.                           up  to  10%  faster),  FileDoor  will mark the
  3545.                           transfer  as  ok,  otherwise  it will mark the
  3546.                           transfer as being not OK. As with  ERRORLEVEL,
  3547.                           you  should  set  the   number  of  files   to
  3548.                           transmit in one turn, to one (see above);
  3549.  
  3550.  [protocol]  On  this  location  you  must  supply  the filename of  the
  3551.              protocol program. You can  select to use only  the filename
  3552.              (DSZ.COM)  or  a  full  path (C:\BBS\PROTOCOL\DSZ.COM). The
  3553.              latter option is  faster in execution  (and more save)  but
  3554.              needs some extra  work when you  shift your protocol  files
  3555.              from one location to another one;
  3556.  
  3557.  [options]   Over here  you place  the options  that are  passed to  the
  3558.              protocol itself. You can  include some macros that  will be
  3559.              replaced by FileDoor at run-time. These are:
  3560.  
  3561.              $1 : Port number (1=COM1:, 2=COM2: etc)
  3562.              $2 : Baudrate
  3563.              $3 : Response file (for DSZ versions later then 880423 and
  3564.                   other protocols);
  3565.              $4 : List of files to be received or sent
  3566.              $5 : Number of minutes left
  3567.              $6 : Number of kB left
  3568.              $7 : Contents of DSZLOG environment variable
  3569.              $8 : Upload Path
  3570.              $M : Swap FileDoor from memory before executing the
  3571.                   protocol
  3572.              $! : If added to the command-line, FileDoor will stop
  3573.                   the time internally and will restart the time
  3574.                   after the protocol has finished;
  3575.  
  3576.  It is advised  to use the  $M as much  as you can  to preserve as  much
  3577.  memory as possible for the protocol !
  3578.  
  3579.  Some general notes about the command-line:
  3580.  
  3581.  - Calling  the  transfer-program  with  a  complete path will load  the
  3582.    program faster than using the DOS path;
  3583.  
  3584.  - $3 is used to generate a  so-called DSZ-alike response file. Most DSZ
  3585.    alike protocols can use this way of accessing the files which have to
  3586.    be downloaded.  When  you  use $3, FileDoor will generate a file with
  3587.    on each line the full path to the file to be downloaded;
  3588.  
  3589.  - $4 is used to generate a command-line, containing ALL files that have
  3590.    to be  downloaded.  The command-line  is  limited (see below). If you
  3591.    MUST use the $4, set the [maxfiles] value to the  value  of 1. Though
  3592.    FileDoor will track the length of the parameter itself, the number of
  3593.    files you can access in one turn (in this way) is VERY limited;
  3594.  
  3595.  - The command-line  in FILEDOOR.CFG is  not limited in  length, however
  3596.    the expanded  command-line as  passed to  DOS for  execution may  not
  3597.    exceed 128 characters. This is DOS limitation;
  3598.  
  3599.  - If you  need a batch-file  to start your  protocol, you may  do it as
  3600.    follows: Other C:\COMMAND.COM /C MYBATCH.BAT [options]
  3601.  
  3602.  Study  the  examples  in  the  supplied FILEDOOR.CFG careful. There are
  3603.  many users of FileDoor.  These users can also  help you with you  quest
  3604.  for the right options.
  3605.  
  3606.  
  3607.  Example : keyword          Download
  3608.             |  efficiency rate |  maximum files
  3609.             |       | key to start  |  minimum baud    Description
  3610.             |       |     |    |    |    |                |
  3611.           Protocol  92    G    D    9    0              YModemG (DSZ)
  3612.  
  3613.           Usage 300 1000 N Y 38400 -Maximum baudrate to be available
  3614.                 \   \    \  \-------Windowed operation
  3615.                  \   \    \---------No ARQ protocol
  3616.                   \    \------------Minimum security to be available
  3617.                    \----------------Minimum baudrate to be available
  3618.  
  3619.           DSZ DSZ.COM Port $1 pB4096 restrict rb -k -g -$3       $M
  3620.             |   |     \----------------------------------------\  |
  3621.             |   |       command-line options ($3 = response file) |
  3622.             |   \-Driver                                          |
  3623.             \-Subtype                  Swap FileDoor to EMS/disk--/
  3624.  
  3625.            ─────────────────────────────────────────────────────────────
  3626.  Means   : Over here you  see a fully explained example of an  entry for
  3627.            download  (key  G,  9  files  max,  92%  efficiency,   called
  3628.            YModemG) that is called by using DSZ.COM.
  3629.            ─────────────────────────────────────────────────────────────
  3630.  
  3631.  
  3632.  
  3633.  3.4 FD_UPD and FILEDOOR.UPD
  3634.  ───────────────────────────────────────────────────────────────────────
  3635.  For  older  QuickBBS  versions  it  is impossible to reload information
  3636.  from the EXITINFO.BBS. FileDoor  will update EXITINFO.BBS with  the new
  3637.  credits so  the BBS  can reload  this information  at once  but for the
  3638.  older QuickBBS this is not possible.
  3639.  
  3640.  In this  case (QuickBBS)  you must  not only  set SYSTEM  QBBS but also
  3641.  NoAutoUpdate  in  FILEDOOR.CFG.  This  means  that  FileDoor will start
  3642.  creating  a  file  called  FILEDOOR.UPD  in  the  supplied   directory.
  3643.  FILEDOOR.UPD is SHARE'ed like FILES.BBS.  This can mean a little  delay
  3644.  at  startup  and  termination  BUT  multiple FileDoor copies can access
  3645.  FILEDOOR.UPD at the  same time, so  you CAN run  multi-line without the
  3646.  problems you had in previous versions.
  3647.  
  3648.  When  FileDOOR.UPD  is  created  it  will  grow  and  grow.  Every time
  3649.  FileDoor will  start it  has to  read FILEDOOR.UPD  to update the users
  3650.  credits  from  the  USERS.BBS  with  the figures from FILEDOOR.UPD. For
  3651.  this reason it is needed to empty  this file once in a while (at  least
  3652.  every 24 hours).
  3653.  
  3654.  In the package you  will find a program  FD_UPD.EXE. In your event  you
  3655.  must run FD_UPD with the FILEDOOR.UPD and the USERS.BBS (QBBS, SBBS  or
  3656.  RA)  in  the  same  directory.  FD_UPD  will  update  the  figures from
  3657.  FILEDOOR.UPD to USERS.BBS and at the end, FILEDOOR.UPD is deleted.
  3658.  
  3659.  
  3660.  
  3661.  ┌───────┬─────────────────────────────────────────────────────────────┐
  3662.  │   4   │ Runtime information                                         │
  3663.  └───────┴─────────────────────────────────────────────────────────────┘
  3664.  
  3665.  4.1 Fast Modems
  3666.  ───────────────────────────────────────────────────────────────────────
  3667.  If you  use a  modem running  with a  locked baudrate  (HST/Telebit/V32
  3668.  modems) you need  to edit the  command-line in the  configuration file.
  3669.  Two things need to be changed:
  3670.  
  3671.  1. Replace all '$2' with the locked baudrate, 1.e. '19200' if you  have
  3672.     fixed the baudrate of your modem to 19200 baud.
  3673.  
  3674.  2. Use  the command-line  options of  the transfer  program so  that it
  3675.     uses hardware handshake (CTS/RTS).
  3676.  
  3677.  Transfer protocols that  use the fossil-driver  for all I/O  don't need
  3678.  any  changes  because  the  fossil   driver  will  take  care  of   the
  3679.  handshaking and the locked baudrate.
  3680.  
  3681.  
  3682.  4.2 Multi line operations
  3683.  ───────────────────────────────────────────────────────────────────────
  3684.  FileDoor will work fine in a multi line setup. Previous versions  could
  3685.  trash files because there was a  chance that the same file was  updates
  3686.  at  the  same  time  on  different  lines  (FILES.BBS  with  FilesCount
  3687.  option).
  3688.  
  3689.  This version  implements full  sharing (when  SHARE.EXE is  loaded) for
  3690.  those  files  that  can  be  accessed  from different lines at the same
  3691.  time. Excluded  are the  log-files. You  can let  FileDoor write to the
  3692.  BBS-log but there must be separate log-files for each line.
  3693.  
  3694.  In some special  cases, the user  is asked to  wait a few  moments when
  3695.  FileDoor is busy with updating  FILES.BBS on two separate lines  at the
  3696.  same time.
  3697.  
  3698.  You should (must)  use different FILEDOOR.CFG  files for each  line you
  3699.  run. A nice way  to implement this, is  to use the BBS's  macro that is
  3700.  replaced with the line-number, inside the call to FileDoor. You  should
  3701.  setup a menu type 7 (or 15) in the following way:
  3702.  
  3703.  C:\UTILS\FILEDOOR.EXE -DD -CC:\UTILS\FILEDOOR.CF*N -N*N *M (RA)
  3704.  
  3705.  In this way, a call on line 1 or 2 is expanded into:
  3706.  
  3707.  C:\UTILS\FILEDOOR.EXE -DD -CC:\UTILS\FILEDOOR.CF1 -N1 *M (RA line 1)
  3708.  C:\UTILS\FILEDOOR.EXE -DD -CC:\UTILS\FILEDOOR.CF2 -N2 *M (RA line 1)
  3709.  
  3710.  There is a  little flaw in  Remote Access that  makes it impossible  to
  3711.  use the *N  more than once  on the command-line.  You can trick  RA and
  3712.  FileDoor by using  *P for the  first *N in  the above command-line  but
  3713.  you can only do this when you your port (COM-port) and line are  always
  3714.  the same (so line 1 is COM1, line 2 is COM2 and so on). If this is  not
  3715.  the  case,  you  can  remove  the  -N*N  option  and  add  BBSLine 1 to
  3716.  FILEDOOR.CF1 and BBSLine 2 to FILEDOOR.CF2.
  3717.  
  3718.  From FileDoor version 3.01 (and up) it is also possible to make use  of
  3719.  a  special  tag  inside  the  FILEDOOR.CFG.  With  this  tag, it is now
  3720.  possible to create one FILEDOOR.CFG that can be used on all lines;
  3721.  
  3722.  All temporary  directories and  files are  made line-specific. FileDoor
  3723.  will use the line-number  in all its temporary  directories, swapfiles,
  3724.  configuration-files and so  on. There are  no chances in  cross-linking
  3725.  any file.
  3726.  
  3727.  WARNING: FileDoor uses  the DSZLOG environment  variable. You must  set
  3728.           this variable to  a directory AND  filename for EACH  line and
  3729.           the values MUST be different, so, for example, use:
  3730.  
  3731.           SET DSZLOG=D:\BBS\RA\RA1\DSZ.LOG  (on line 1)
  3732.           SET DSZLOG=D:\BBS\RA\RA2\DSZ.LOG  (on line 2)
  3733.  
  3734.           If DSZLOG  is not  set, FileDoor  will create  one of its own.
  3735.           If it is  set, even then  FileDoor will ALTER  the value while
  3736.           FileDoor is active unless a special option is set
  3737.  
  3738.  
  3739.  4.3 Swapping
  3740.  ───────────────────────────────────────────────────────────────────────
  3741.  When you run  a BBS, you  already know what  swapping is. FileDoor  can
  3742.  swap itself from memory when the  protocol is called. In this case  you
  3743.  must include $M into the command-line of the protocol(s).
  3744.  
  3745.  FileDoor will first look  for EMS, if not  available than XMS is  used,
  3746.  if not available  than extended memory  is used, if  not available than
  3747.  DISK is used (the SwapPath option  !). EMS and XMS can be  skipped when
  3748.  you set the NoEMS and/or NoXMS options in FILEDOOR.CFG !
  3749.  
  3750.  
  3751.  4.4 FileDoor/DISP-compatible tag-file <tm>
  3752.  ───────────────────────────────────────────────────────────────────────
  3753.  FileDoor can use  a FileDoor/DISP-compatible tag-file  <tm>. This is  a
  3754.  special structure, created  by other doors  like the DISP-programs  MTS
  3755.  and RFW. This  tag-file will contain  all the information  for FileDoor
  3756.  to access the filenames contained in this tag-file easy.
  3757.  
  3758.  Other  products  can  give  an  option  to store information inside the
  3759.  tag-file (filenames) and FileDoor  can (later) access this  information
  3760.  In some way, the tag-file is a type of Clipboard where the user  stores
  3761.  filenames  to  remember  and  that  can  be  recalled  by  the FileDoor
  3762.  program.
  3763.  
  3764.  FileDoor can  use two  kinds of  tag-files. The  first one  is a normal
  3765.  tag-file. The user MUST enter /TAG on the FileDoor selection  question.
  3766.  The second one is a so called AUTOLOAD tag-file. When the user  selects
  3767.  the download-menu, FileDoor  will load the  tag-file without having  to
  3768.  enter the /TAG on the selection line. The user is still able to  select
  3769.  or deny the tagged files. MTS and RFW will create autoload tagfiles.
  3770.  
  3771.  When  FileDoor  recognizes  a  AUTOLOAD  tag-file,  it will display all
  3772.  stored files for  the user, so  the user can  add them to  the download
  3773.  list or skip them. Also FileDoor  will remove the AUTOLOAD flag so  the
  3774.  next time  FileDoor is  started, there  is still  a tag-file  (the same
  3775.  when no  new tag-file  is created)  but the  user MUST  access the file
  3776.  with /TAG.
  3777.  
  3778.  When  FileDoor  starts,  it  will  look  for BBSTAGFL.n (where n is the
  3779.  line-number).  If  available,  FileDoor  will  check  if  this tag-file
  3780.  belongs to this user (with a name-compare). If this is not the case  or
  3781.  when  the  file  is  not  compatible (IO-error, invalid), FileDoor will
  3782.  remove it and /TAG is not possible.
  3783.  
  3784.  
  3785.  4.5 File selection
  3786.  ───────────────────────────────────────────────────────────────────────
  3787.  Reading  this  chapter  can  make  the  difference  in FileDoor's speed
  3788.  between a turtle and a road-runner (miep-miep).
  3789.  
  3790.  You must think carefully how you will implement file selection for  the
  3791.  user. FileDoor offers a complete  set of file selection methods  but it
  3792.  would be  nice if  you used  the one  that suits  your environment (and
  3793.  type of users).
  3794.  
  3795.  FileDoor does everything from the  point of the 'complete' set.  See it
  3796.  as a type of OOP way  of working. The 'root' is the  complete selection
  3797.  and both you  and the users  can vary the  behavior of this  'root'. Be
  3798.  warned though  that you  alter the  description of  the file  selection
  3799.  help-file to the  choice you have  made. A generalized  example of this
  3800.  help-file is included in the release archive.
  3801.  
  3802.  The 'root' is the base of  all file selections that the user  can make.
  3803.  By default, FileDoor will use this 'root' method. A short description:
  3804.  
  3805.  - The user is presented a line  where she/he can enter 1 to the  length
  3806.    of the line  file-masks. The different  masks must be  separated with
  3807.    at least 1 space;
  3808.  
  3809.  - After  entering,  FileDoor  starts  searching  the area(s) for  every
  3810.    mask;
  3811.  
  3812.  - When a match  is found, FileDoor will  ask the user (Y/N)  if this is
  3813.    the file  that is  requested. If  'Y', FileDoor  will add  it to  the
  3814.    list;
  3815.  
  3816.  - In both  cases, FileDoor will  continue the search  in the same  (and
  3817.    following, when AutoSearch  is set) area(s)  to search for  this mask
  3818.    until no match is left in either this or any other area(s);
  3819.  
  3820.  The big  benefit of  this way  of selecting  files is,  that it is very
  3821.  friendly for the user, but advanced users will not like it at all.
  3822.  
  3823.  Now there  is an  escape for  this way  of working  and one  that comes
  3824.  close to the way that FileDoor 1.xx used. The user can enter /Q as  the
  3825.  last  filemask  and  in  this  case  ALL  matches  are  taken   without
  3826.  questions,  either  until  limits  are  exceeded  or there are too many
  3827.  files. The user will jump directly to the protocol (or the question  to
  3828.  start the protocol) and can go on from here.
  3829.  
  3830.  Until now the  user had only  something to tell.  The above method  has
  3831.  still one  problem. When  FileDoor finds  a match  it will still search
  3832.  all eligible area's for more matches for the same file. This is  needed
  3833.  in those cases where  name-like files can be  available in two or  more
  3834.  different area's. In  that case FileDoor  MUST search because  the user
  3835.  could want the  second (3th and  so on) and  not the first  match. When
  3836.  this is not the case, FileDoor can be implemented with another  method.
  3837.  There are two (related, but different) ways to do so:
  3838.  
  3839.  - Add the ExactMatch in FileDoor.CFG;
  3840.  
  3841.  - Now searching will as before  but if the user enters a  FULL filename
  3842.    (without  wildcards),  FileDoor  will  take  the first file with that
  3843.    name that is found and no questions are asked for that file;
  3844.  
  3845.  - The user can still  make multiple selections by including  a wildcard
  3846.    in the name. Now  FileDoor will go on  searching for this file  until
  3847.    all available matches in all areas are processed;
  3848.  
  3849.  There is a more radical method:
  3850.  
  3851.  - Add the QuickMatch option in FileDoor.CFG;
  3852.  
  3853.  - Now searching will be different.  If a file matches a supplied  mask,
  3854.    the file is taken (no questions) and the mask is removed. Only  other
  3855.    masks that did not match  until now, will processed until  either all
  3856.    files  are  found  (e.g.  all  masks  are  removed)  or all files are
  3857.    processed (all areas have been processed when autosearch is on);
  3858.  
  3859.  - The user is STILL able to  overrule this method but in that case  the
  3860.    user must  enter /S  at the  end of  list of  masks. In that case the
  3861.    search will be the same as with the 'root' method;
  3862.  
  3863.  There is  one big  advantage with  ExactMatch or  QuickMatch (never use
  3864.  them  both,  QuickMatch  will  overrule  ExactMatch but the program can
  3865.  slowdown  a  bit).  This  advantage  is  speed.  In  the  'root' model,
  3866.  FileDoor keeps on  searching, even if  all files are  already selected,
  3867.  for a  possible other  match. This  is less  with the ExactMatch method
  3868.  (but the user must enter full names) and gone with the QuickMatch.  The
  3869.  number of  informative lines  with each  option will  be less than with
  3870.  the 'root' method.
  3871.  
  3872.  I suggest you only use QuickMatch on slow machines, big BBS's or  those
  3873.  BBS's that  have their  CD-rom as  the last  area(s) of  the list.  The
  3874.  ExactMatch is  somewhat in-between.  FileDoor is  at its  most friendly
  3875.  with both options set  to off while there  is still a quick  method for
  3876.  users who want is.
  3877.  
  3878.  
  3879.  4.6 Selection with wildcards
  3880.  ───────────────────────────────────────────────────────────────────────
  3881.  When  the  user  enters  filenames  with  wildcards,  all available DOS
  3882.  wildcards  (these  are  '?'  and  '*')  are possible. FileDoor (up from
  3883.  release 3.01) extends the masks in two ways with both the same result:
  3884.  
  3885.  - The user can use the  DISP-compatible wildcard If a user enters  =MTA
  3886.    as a filemask, FileDoor will  examine all files and those  files that
  3887.    have the word MTA inside will be matched. This is a 'shifted'  match.
  3888.    =TA.Z will match mTA.Zip, =V90  will match the files scanV90.ZIP  and
  3889.    cleanV90.zip and so on;
  3890.  
  3891.  - The  user  can  use  the  4DOS  <tm>-compatible wildcard If the  user
  3892.    enters *MTA*.* it will  be expanded to =MTA  and will do the  same as
  3893.    the DISP-compatible wildcard. With 4DOS-compatible wildcards you  can
  3894.    not search 'over the point' like with the previous method !
  3895.  
  3896.  Both new wildcards will have  one drawback. When FileDoor searches  for
  3897.  files  with  NORMAL  wildcards,  it  uses  DOS FindFirst/FindNext calls
  3898.  which are very quick (in fact there are not that many  protocol-drivers
  3899.  that  are  as  fast  as  FileDoor).  When  the  user enters the special
  3900.  wildcard, ALL files must be examined and this will take extra time.
  3901.  
  3902.  
  3903.  4.7 Sysop-to-User files
  3904.  ───────────────────────────────────────────────────────────────────────
  3905.  FileDoor implements  a new  method of  putting special  files aside for
  3906.  SysOp's friend (or enemies). When  the Sysop uses the program  FileUSER
  3907.  (it is more or less self explaining), she/he can put files aside for  a
  3908.  specific user PROVIDED THAT THE NAME ENTERED ON THE FILEUSER PROMPT  IS
  3909.  AN EXACT  MATCH with  the name  the user  uses on  the BBS (there is no
  3910.  check yet).
  3911.  
  3912.  If you choose to do  so, you can select if  these files are to be  free
  3913.  or  not  and  FILEUSER  will  put  the  files  aside for the user (in a
  3914.  special directory).  In fact  there are  COPIES of  these files in that
  3915.  special directory. This  is done, because  FileDoor itself will  remove
  3916.  (delete) the files  after the user  downloaded those files.  The syntax
  3917.  for FILEUSER is:
  3918.  
  3919.  FILEUSER {-C[filedoor.cfg]} {-N[line]}
  3920.  
  3921.  -C and -N  can be used  just as with  FileDoor itself (see  chapter 3).
  3922.  The -N  is only  used to  select the  right statements  if you  use the
  3923.  line-tags in FILEDOOR.CFG.
  3924.  
  3925.  FILEUSER itself is pretty much  self-explaining. You will get a  screen
  3926.  where you can enter  the filename. If you  just hit the [ENTER]  key, a
  3927.  tag-list is presented and you can  select one or more files (you   must
  3928.  tag them with the  space-bar and after tagging  you must hit the  [ESC]
  3929.  button). Also you will be asked the name of the user to send the  files
  3930.  to. FILEUSER will ask a description  for the whole package (it will  be
  3931.  shown to the user when she/he  enters FileDoor) and you can supply  the
  3932.  description of each of the files.
  3933.  
  3934.  
  3935.  
  3936.  You can use FILEMAIN on a regular basis (inside the event) to clean  up
  3937.  files that have been set aside  but were not collected. The syntax  for
  3938.  FILEMAIN is:
  3939.  
  3940.  FILEMAIN R|U [days] {-C[filedoor.cfg]} {-N[line]}
  3941.  
  3942.  At this moment, only the U can be used. If you use 'FILEMAIN U 10'  and
  3943.  run it in  the daily event,  FILEMAIN will cleanup  all files (and  the
  3944.  temporary directories) that are  10 days or older.  -C and -N have  the
  3945.  same meaning  as with  the normal  FILEDOOR.EXE program.  -N is used to
  3946.  examine the line-tags inside FILEDOOR.CFG.  If you don't use them,  you
  3947.  do not have to supply -N.
  3948.  
  3949.  
  3950.  If you have set aside some  files for someone and that user  enters the
  3951.  FileDoor program,  she/he will  get a  message, telling  that there are
  3952.  files available for her/him. The  user can now select the  files, start
  3953.  the download and return to  FileDoor. After a successful download,  the
  3954.  files  are  removed  until  the  last  file is removed from the special
  3955.  directory, in which  case FileDoor itself  will remove the  other files
  3956.  (the tag-file, the FILES.BBS) and  the directory. If the user  does not
  3957.  want to download the  files, she/he can use  the /UDEL macro to  delete
  3958.  all private files at  once. If the user  WANTS to select the  file, the
  3959.  /USER macro can be used to do so !
  3960.  
  3961.  
  3962.  In later  versions of  FileDoor, these  options will  be extended.  The
  3963.  interface is  'closed'. It  is not  hard to  find out  the way it works
  3964.  but there is no guaranty that it will stay this way. Only the  supplied
  3965.  files (FILEMAIN and FILEUSER) will be at the same level as FILEDOOR.EXE
  3966.  itself and can be used as such.
  3967.  
  3968.  
  3969.  4.8 Local keyboard codes
  3970.  ───────────────────────────────────────────────────────────────────────
  3971.  When FileDoor is active, you  can use several ALT-key combinations  for
  3972.  different tasks. These are:
  3973.  
  3974.  - ALT-J   Jump to DOS          The user gets a message that you    have
  3975.                                 shelled to DOS. Jump with a HOT-fossil;
  3976.  
  3977.  - ALT-H   Hangup               This  lowers the DTR of the modem    and
  3978.                                 the connection is zapped;
  3979.  
  3980.  - ALT-G   Hangup + message     This lowers  the DTR of the  modem   and
  3981.                                 the  connection  is  zapped.  Before the
  3982.                                 disconnect,  the  GOODBYE.Axx  file   is
  3983.                                 shown to the user;
  3984.  
  3985.  - ALT-X   Lock keyboard        This will lock the keyboard until  ALT-U
  3986.                                 is given  (only works  when LOCKPASSWORD
  3987.                                 option is set in FILEDOOR.CFG);
  3988.  
  3989.  - ALT-U   Unlock Keyboard      This will  unlock  the local    keyboard
  3990.                                 after  you  have  supplied  the  correct
  3991.                                 password;
  3992.  
  3993.  - ALT-C   Chat mode            This will   enter the external      chat
  3994.                                 program (only  when ExternalChat  is set
  3995.                                 in FILEDOOR.CFG);
  3996.  
  3997.  - ALT-B   Back                 This will end FileDoor and will    place
  3998.                                 the user back in the BBS program;
  3999.  
  4000.  Also you  can use  some function-keys  to toggle  the status-bar on the
  4001.  local screen (if set).
  4002.  
  4003.  
  4004.  4.9 FILES.CTL and BADFILES.CTL
  4005.  ───────────────────────────────────────────────────────────────────────
  4006.  FileDoor  can   access  two   special  files   called  FILES.CTL    and
  4007.  BADFILES.CTL. These  files are  common to  most QuickBBS/RA/SBBS  alike
  4008.  BBS  programs.  The  syntax  for  these  two  files can be found in the
  4009.  documentation of  your BBS  program, but  I will  include some  limited
  4010.  information over here:
  4011.  
  4012.  - BADFILES.CTL
  4013.    This file contains  lines with on  every line a  file-mask (wildcards
  4014.    are allowed) of files that  are unwanted for upload. The  information
  4015.    in  this  file  is  merged  with  the  information  from the UNWANTED
  4016.    options in FILEDOOR.CFG. Duplicated masks will be dropped;
  4017.  
  4018.  - FILES.CTL
  4019.    This is a special macro-file with the following syntax:
  4020.  
  4021.    [mask] {/UNWANTED} {/FREE} {/PWD=password}
  4022.  
  4023.    QuickBBS <tm> and Remote Access  <tm> don't use the /UNWANTED  option
  4024.    (they use the BADFILES.CTL)  but SuperBBS <tm> does.  From FileDoor's
  4025.    point of view, it is perfectly safe to use the /UNWANTED switch in  a
  4026.    Remote  Access  environment  also.  [mask]  is  a  filemask  (with or
  4027.    without directories  and wildcards).  If you  use /UNWANTED,  it will
  4028.    mean that the  file is unwanted  for upload and  will be merged  with
  4029.    the masks from BADFILES.CTL and the UNWANTED option in  FILEDOOR.CFG.
  4030.    Duplicated masks are  not stored by  FileDoor. The same  goes for the
  4031.    /FREE option. It  means that a  download of such  a file is  free for
  4032.    the user. The  masks with /FREE  are merged with  the FREEFILE option
  4033.    in FILEDOOR.CFG. /PWD means that a file is protected with a  password
  4034.    and that this password must  be supplied for a download.  These files
  4035.    are  merged  with  those  reported  in  the PASSWORDPROTECT option in
  4036.    FILEDOOR.CFG.
  4037.  
  4038.  You must know that FileDoor will store all information from  FILES.CTL,
  4039.  BADFILES.CTL and the FreeFile, Unwanted and PasswordProtect options  in
  4040.  dynamic memory.  The more  options you  use, the  more memory  FileDoor
  4041.  will need. You are advised to limit the number of options and files  in
  4042.  FILES.CTL/BADFILES.CTL as much as possible.
  4043.  
  4044.  
  4045.  4.10  FileDoor and conversion exits (MTA.EXE and others)
  4046.  ───────────────────────────────────────────────────────────────────────
  4047.  One of  the strongest  points for  the upload-part  of FileDoor  is the
  4048.  (possible) usage of  exits. There are  3 exit-points defines  (assigned
  4049.  by   the   ExitAfterUpload1,   ExitAfterUpload2   and  ExitAfterUpload3
  4050.  options) that are  called one after  each other. They  are called AFTER
  4051.  the transfer but BEFORE FileDoor starts checking the files. This  means
  4052.  that the programs, called inside one or more exits, can manipulate  the
  4053.  files BEFORE FileDoor can lay its hands on them.
  4054.  
  4055.  After all exits  are called, FileDoor  will start looking  for a number
  4056.  of (so called) semaphore files that can be left behind by the  programs
  4057.  that were called in the exit(s).  There are 3 semaphore files that  the
  4058.  FileDoor program will look for. They are (with their internal format):
  4059.  
  4060.  nnnnnnnn.XS1  The  nnnnnnnn is equal  to a filename  already inside the
  4061.                temporary upload directory. If  this file is present,  it
  4062.                contains  4  bytes  (making  a  PASCAL  LONGINT) with the
  4063.                original  length  of  the  file  after the transfer. This
  4064.                semaphore  is  very  useful  when  the user uploads A.ARC
  4065.                (will result  in a  semaphore file  A.XS1) which  is then
  4066.                converted inside the  exit to A.ARJ  (which will be  much
  4067.                smaller).  If  the  semaphore  is  created, FileDoor will
  4068.                count  the  ORIGINAL  length  of  A.ARC  and  not the new
  4069.                length of A.ARJ;
  4070.  
  4071.  FILEDOOR.XS2  This semaphore  is a  text-file with  records which   are
  4072.                made up of 12 bytes with the ORIGINAL filename after  the
  4073.                transfer  AND  12  bytes  with  the  new  name  after   a
  4074.                conversion. The  file can  contain a  unlimited number of
  4075.                24-byte records.   If you run  a conversion program  that
  4076.                converts  A.ARC  into  A.ARJ  but  the  user supplied the
  4077.                comment to A.ARC BEFORE the transfer, FileDoor would  not
  4078.                detect  the   file  after   the  transfer   because   the
  4079.                conversion  has  renamed  it  to  A.ARJ.  In  that   case
  4080.                FileDoor would ask a comment for A.ARJ from the user.  If
  4081.                the  conversion  renames  the  file,  it should create an
  4082.                entry in FILEDOOR.XS2  with the old  and new name  in one
  4083.                24-byte  record.  FileDoor  will  read the semaphore file
  4084.                and will know that A.ARC has been renamed to A.ARJ;
  4085.  
  4086.  FILEDOOR.XS3  This semaphore  is a  text-file which  contains sets   of
  4087.                records  (9  records  per  set).  The first record is the
  4088.                name of the file, the  second to 9th record each  contain
  4089.                1 to  45 bytes  of text.   If your  conversion program is
  4090.                able  to  extract  a  comments  from  the  archives (most
  4091.                obvious  is  the  FILE_ID.DIZ  file),  it  can then store
  4092.                these comments  in the  FILEDOOR.XS3 file  which will  be
  4093.                read by FileDoor. FileDoor  can then use the  comments as
  4094.                defined by the SysOp (see InternalOverUser option);
  4095.  
  4096.  One other 'trick' to mention is the removal of uploaded files. If  your
  4097.  exit can test  for a virus  and finds one  inside an uploaded  file, or
  4098.  you run a  GIF-test program that  detects an invalid  GIF, it can  then
  4099.  move that file  to some trashcan  (or even delete  it). If the  file is
  4100.  gone from the  temporary upload-directory, FileDoor  won't count it  at
  4101.  all !
  4102.  
  4103.  One  program  (obvious)  that  can  make  use  of  all these options is
  4104.  MTA.EXE (by DISP). If you use the /STOSIZ, /STOCOM and /STONAM  options
  4105.  when  you  run  MTA  from  within  a  FileDoor-exit, it will create the
  4106.  mentioned semaphore files. Also (even when running in SIMULATE run)  it
  4107.  can detect an invalid archive or call a virus-test program. If  illegal
  4108.  files are  found, it  will move  them to  another place before FileDoor
  4109.  will get its hands on it.
  4110.  
  4111.  Soon there will be separate programs available that can run inside  the
  4112.  exits and  that can  do smaller  (faster) jobs  than MTA.EXE.  If it is
  4113.  just the  FILE_ID.DIZ file  you are  after you  should wait  for such a
  4114.  program, though MTA.EXE can  do the job fine  (along with a test  for a
  4115.  virus and more, even without conversion).
  4116.  
  4117.  I have made it  a policy to make  this functions 'external'. This  will
  4118.  reduce the number  of updates on  FileDoor itself because  it can still
  4119.  run when  a new  type of  comment-file hits  the marked,  new archivers
  4120.  come  by,  archivers  need  new  parameters  and  so on. Also the total
  4121.  memory needed by FileDoor is reduced, so the 'bare-bone' user will  not
  4122.  have the overhead for these options !
  4123.  
  4124.  
  4125.  
  4126.  ┌───────┬─────────────────────────────────────────────────────────────┐
  4127.  │   5   │ Version information and credits                             │
  4128.  └───────┴─────────────────────────────────────────────────────────────┘
  4129.  
  4130.  5.1 The BETA-team
  4131.  ───────────────────────────────────────────────────────────────────────
  4132.  Look into the file SUPPORT.XFD for a full list of all BETA testers  and
  4133.  support nodes.
  4134.  
  4135.  
  4136.  
  4137.  5.2 Credits
  4138.  ───────────────────────────────────────────────────────────────────────
  4139.  Thanks to the following people:
  4140.  
  4141.  - Stig  Jacobsen  for  developing  FileDoor  and making it possible  to
  4142.    create a State of the Art file-protocol interface.
  4143.  
  4144.  - All  registered users.  You make  it worthwhile  to enhance  FileDoor
  4145.    with nice features;
  4146.  
  4147.  - All users who did write a message and/or sent me a postcard;
  4148.  
  4149.  - The 'true' believers that FileDoor is leading the marked for a  price
  4150.    that no one can match;
  4151.  
  4152.  - The BETA-team;
  4153.  
  4154.  
  4155.  
  4156.  5.3 Version history
  4157.  ───────────────────────────────────────────────────────────────────────
  4158.  
  4159.  ┌───────┬────────────────────────────┐
  4160.  │ 2.01  │ Complete rewrite           │
  4161.  └───────┴────────────────────────────┘
  4162.   ■ The first release  after the all rights  and source codes have  been
  4163.     transferred from Stig Jacobsen to Rob van Hoeven. Can still  contain
  4164.     bugs (even DOS does) so......
  4165.  
  4166.  ┌───────┬────────────────────────────┐
  4167.  │ 2.01a │ Bug release                │
  4168.  └───────┴────────────────────────────┘
  4169.   ■ Bimodem  would  fail  (displaying  help-screen) in some  situations.
  4170.     This is fixed;
  4171.  
  4172.   ■ All protocols would give  various errors in local mode  because most
  4173.     of the time the COM0  (invalid port) was passed. Local  testing will
  4174.     now bring a window on-screen  with the call that FileDoor  will make
  4175.     (program, location, options) when running remote;
  4176.  
  4177.   ■ GIF files  were not counted  as archives. This  is (temporary) fixed
  4178.     by including them as archive extension;
  4179.  
  4180.   ■ Backspace  on  remote  side  was  not (always) destructive. This  is
  4181.     replaced with a 'backspace, space, backspace' combination;
  4182.  
  4183.   ■ Fixed  some internal  coding. Credit  scoring for  Bimodem upload in
  4184.     download-menu was not counted. Fixed;
  4185.  
  4186.   ■ PFILES.BBS was a selectable file. This is now fixed. PFILES.BBS  and
  4187.     PFILES.BAK are now skipped;
  4188.  
  4189.   ■ Fixed  problem  with  the  upload-exits.  They were not called  when
  4190.     Bimodem (possible uploads!) was selected in -DD or -DB menus;
  4191.  
  4192.   ■ Added a new option, HideFiles;
  4193.  
  4194.   ■ Added  support for  MTA 14.45  recompressing utility  under FileDoor
  4195.     ExitAfterUploadx options;
  4196.  
  4197.  ┌───────┬────────────────────────────┐
  4198.  │ 2.02  │ 'Minor' and bug release    │
  4199.  └───────┴────────────────────────────┘
  4200.   ■ Fixed a problem where the download of Bimodem files was not  counted
  4201.     at all;
  4202.  
  4203.   ■ Aborted downloads in either  DSZ, Other or OPUS flavour  were always
  4204.     counted.  This  could  cause  the  following scenario. Download 40K,
  4205.     abort  after  20K,  resume,  abort  at  30K,  resume,  abort at 39K,
  4206.     resume,  done.  The  user  was  counted for 20+30+39+40=129K and not
  4207.     40K. This is fixed;
  4208.  
  4209.   ■ Errorlevel  uploads  could  be  counted  as  wrong when an exit  was
  4210.     called after the upload. This is fixed;
  4211.  
  4212.   ■ The  problem  with  MinSpace  is  fixed  at last (I hope). Both  the
  4213.     inter- nal coding  AND the method  are changed. I  now use a  faster
  4214.     method  and  will  also  be  able  to  cover  more  type  of  drives
  4215.     (RAM-disk, LAN drives, SUBST-drives, ASSIGNed drives and such);
  4216.  
  4217.   ■ There  is  a  flaw  in  some  BBS  programs that causes FileDoor  to
  4218.     display a very large number for the remaining download-credit.  This
  4219.     is the case when  the downloaded KB's is  set higher than the  limit
  4220.     (by the Sysop). This  causes the reversed to  happen. This is NOT  a
  4221.     problem of FileDoor but a problem  of the BBS that passes the  wrong
  4222.     value to  the door.  A message  is send  to the  author(s) of  those
  4223.     BBS's;
  4224.  
  4225.   ■ When there is no specific  log-file present (all 3 types) and  there
  4226.     is nothing to add  also, FileDoor would create  a log-file with a  0
  4227.     byte length. This is fixed;
  4228.  
  4229.   ■ The special  upload/download log contained  the name of  the day and
  4230.     not the month. This is fixed;
  4231.  
  4232.   ■ For SBBS users, the name of FILES.SBS is changed in FLSEARCH.CTL;
  4233.  
  4234.   ■ Clarified the search for FileDoor.CFG in the documentation;
  4235.  
  4236.   ■ Fixed a problem with the sharing of FILES.RA (and alike) files;
  4237.  
  4238.   ■ Fixed a problem with the sharing of HLP_*.* and MNU_*.* files;
  4239.  
  4240.   ■ The ASCII help-files could not be found. This is fixed;
  4241.  
  4242.   ■ Fixed various errors with errorlevel/other protocols and download;
  4243.  
  4244.   ■ Fixed the calls to various protocols (Bimodem to name one);
  4245.  
  4246.   ■ LHA  archives with  level-2 headers  would not  be detected. This is
  4247.     fixed;
  4248.  
  4249.   ■ If -U is present on the  call to FileDoor (and also -P, see  later),
  4250.     FileDoor  will  not  check  any  UploadPath  (PUploadPath) option in
  4251.     FileDoor.Cfg for valid data;
  4252.  
  4253.   ■ Using // in the wrong  way caused the previous selection (or  trash)
  4254.     to be displayed on the display. This is fixed;
  4255.  
  4256.   ■ After  the  selection  of  the  protocol,  FileDoor will now send  a
  4257.     clear-screen so there will be no trashed screen at the user side;
  4258.  
  4259.   ■ Added the NOEMS and NOXMS options;
  4260.  
  4261.   ■ Added PUploadPath  (and -P) to  move private uploads  to a different
  4262.     directory than the upload-directory (if wanted);
  4263.  
  4264.   ■ Did a complete  facelist to the file-selection.  Added /Q, /S to  be
  4265.     used by the  user and ExactMatch  and QuickMatch to  be used by  the
  4266.     Sysop. See the new chapter for a discussion on the file- selection;
  4267.  
  4268.   ■ Changed the support  for //. There will  be a separate question  for
  4269.     the password and this password is protected on-screen with '*'.
  4270.  
  4271.   ■ Added  AlienArchive option  to point  to special  types of  archives
  4272.     that FileDoor has no knowledge of.
  4273.  
  4274.  
  4275.  ┌───────┬────────────────────────────┐
  4276.  │ 2.03  │ 'Minor' and bug release    │
  4277.  └───────┴────────────────────────────┘
  4278.   Be prepared for  a long list  of bugs, changes  and features. It  took
  4279.   some time to  create the new  version so many  user requests could  be
  4280.   implemented (others are implemented in  2.10, the next release).   The
  4281.   basic idea behind this release is to fix the real problems and to  add
  4282.   some small gigs. A  small line in this  list can make your  day (or it
  4283.   won't) !!!
  4284.  
  4285.   ■ Fixed the flag-support. It now works like the BBS. This should be  a
  4286.     relief;
  4287.  
  4288.   ■ Fixed  the CTRL-Z  problem that  caused the  FILES.BBS to  trash and
  4289.     make some editors go  wild. Also the uploads  will be logged in  the
  4290.     FILES.BBS ok (and no trash);
  4291.  
  4292.   ■ Fixed the hangup  in FileDoor that was  caused when a user  used the
  4293.     Bimodem <tm> protocol  (registered or hacked)  and added some  files
  4294.     to download.  It could  result in  hanging FileDoor,  hanging multi-
  4295.     tasker, hanging machine or other strange things (I was trashing  the
  4296.     PC's memory);
  4297.  
  4298.   ■ Fixed  the problem  in multi-line  operations with  the 'SYSTEM FILE
  4299.     (FILES.RA)  NOT  FOUND'  error.  I  was  sharing the file (thank you
  4300.     folks, I received as many 'It is sharing-code 64' messages as I  got
  4301.     registrations) but  forgot the  sharing in  one S.O.B.  part of  the
  4302.     program (a removed line);
  4303.  
  4304.   ■ Fixed  the problem  where users  were removed  from FileDoor  for no
  4305.     reason with the  CARRIER LOST or  TIMEOUT/LOCKOUT message. This  was
  4306.     caused because of a weak filer in the input;
  4307.  
  4308.   ■ Fixed  the  problem  where  users  could enter control-codes in  the
  4309.     input lines (same weak filer as above);
  4310.  
  4311.   ■ Fixed the  problem where users  would enter a  file to upload  twice
  4312.     (or  more)  in  the  pre-selection,  sending them once, and FileDoor
  4313.     counting it twice (or more);
  4314.  
  4315.   ■ Fixed the  problem with the  RC=2 error when  the protocols were  in
  4316.     the current directory when FileDoor got control;
  4317.  
  4318.   ■ The input-buffer  was not cleared  so when the  user pressed 'Y'  or
  4319.     'N' to  hard, they  got more  ('Y') or  less ('N')  files than  they
  4320.     wanted. Now the buffer is cleared before the next question;
  4321.  
  4322.   ■ With QuickMatch  on, it was  possible to enter  *.* or ????????.???.
  4323.     This is now filtered as a wrong file-mask;
  4324.  
  4325.   ■ Changed the user's command-line.  The '[CR] to start download'  will
  4326.     only be presented  when a file  is selected (excluded  is the infor-
  4327.     mation file, see later) or when Bimodem is used;
  4328.  
  4329.   ■ Added the DupePath option to allow the movement (and not delete)  of
  4330.     duplicate files to a special directory;
  4331.  
  4332.   ■ Fixed a bug where FileDoor  was counting IMb+ files as one  tenth of
  4333.     their actual size;
  4334.  
  4335.   ■ Fixed a bug where FileDoor  was not seeing duplicate files when  the
  4336.     BBS was using ARJ for most files;
  4337.  
  4338.   ■ Reconfigured  the logging  (see documentation).  It is  important to
  4339.     take some time  to add the  new features OTHERWISE  LOGGING WILL RE-
  4340.     SULT IN EMPTY LINES IN YOUR LOG !!!!!!!
  4341.  
  4342.   ■ Dupe files (upload) can now also be logged (see documentation);
  4343.  
  4344.   ■ Made the selection display somewhat smaller and added an option  for
  4345.     the  user  to  read  extended  information  about  a file. This will
  4346.     include the  comment (up  to 250  bytes, QFV/F/C  +-commentline com-
  4347.     patible), the name of the area, the size, the date and the time;
  4348.  
  4349.   ■ Enhanced  the  Color  option  with  some  colors  that could not  be
  4350.     changed. Now they can;
  4351.  
  4352.   ■ Fixed 80% of the FOSSIL routines, causing less ticks to be  snatched
  4353.     from your other task(s) (under multitasking);
  4354.  
  4355.   ■ Added a Debug option;
  4356.  
  4357.   ■ Added a HelpExitKeys option;
  4358.  
  4359.   ■ Added a NotAvailText option;
  4360.  
  4361.   ■ Added the ExitAfterDownload option  to call an exit after  the down-
  4362.     load;
  4363.  
  4364.   ■ Added  information-file options.  The user  can now  also download a
  4365.     file with comments of the (previously) selected or downloaded  files
  4366.     EVEN with protocols that allow only 1 download at any time.  If  the
  4367.     user stays in FileDoor, the info-file is kept and can be  downloaded
  4368.     UNLESS the user exits from FileDoor. Added the option DownloadInfo;
  4369.  
  4370.   ■ If  the user  selects <G>oodbye  after transfer,  FileDoor will  now
  4371.     display the GOODBYE.A?? screen;
  4372.  
  4373.   ■ If  the user  tries to  download outside  the normal hours, FileDoor
  4374.     will display the DNLDHRS.A?? file;
  4375.  
  4376.   ■ If the HLP_????  file is not present,  FileDoor will try to  display
  4377.     XFERHELP.A?? (if present);
  4378.  
  4379.   ■ Fixed  a  bug  where  FileDoor  could leave the temporary  directory
  4380.     after a transfer. This is fixed;
  4381.  
  4382.   ■ Added  some space  to allow  up to  255 protocols  PER direction BUT
  4383.     remember that the  screen will scroll  and every protocol  will take
  4384.     up to 172 bytes of memory;
  4385.  
  4386.   ■ Added ANSASC option to use  different names for the menus and  help-
  4387.     files;
  4388.  
  4389.   ■ Added explicit support for SBBS 1.11 and up (FLSEARCH.BBS);
  4390.  
  4391.  
  4392.  ┌───────┬────────────────────────────┐
  4393.  │ 3.01  │ Major release              │
  4394.  └───────┴────────────────────────────┘
  4395.  I have split the 'what's new' information into 3 parts, the fixed  bug,
  4396.  any removed options and added (and enhanced) options.
  4397.  
  4398.  
  4399.  Bug fixes:
  4400.  ───────────────────────────
  4401.  ■ Fixed a problem  where filename in FILES.BBS  in mixed case were  not
  4402.    updated and counted;
  4403.  
  4404.  ■ Fixed  the major  part of  all swapping  and shell  routines. On some
  4405.    machines they would hang;
  4406.  
  4407.  ■ The complete  RATIO-system is revamped.  It worked rather  at random.
  4408.    Some  users  could  use  it,  others  didn't.  With the revamping all
  4409.    critical errors are removed;
  4410.  
  4411.  ■ Fixed  a problem  with the  %X macro  in the  logging-layout. When is
  4412.    wasn't needed, it wasn't replaced by a null-string. Now it is;
  4413.  
  4414.  ■ FileDoor  would  not  work  ok  with  some  combinations of the  DISP
  4415.    compatible  +-comment-lines  in  FILES.BBS.  This  part has also been
  4416.    rewritten;
  4417.  
  4418.  ■ When using Quickmatch, it was still possible to enter the file  masks
  4419.    *.* and/or ????????.???.  This would cause  all files to  be selected
  4420.    (up to the  users limit). Though  it is a  user-error, the masks  are
  4421.    denied when QuickMatch is on;
  4422.  
  4423.  ■ FileDoor would  show the N/A-text  on locations where  there actually
  4424.    was a description. This is fixed;
  4425.  
  4426.  ■ Bimodem uploads  for filename.ext would  also cause a  schedule for a
  4427.    download for filename.ext. This would  fail but the error in  Bimodem
  4428.    was not nice. Fixed;
  4429.  
  4430.  ■ All  kind  of  strange  things  would  happen if the user passed  the
  4431.    available time  (uploads). In  these cases  the user  was not able to
  4432.    enter  file-comments  and  some  files  were  left  in  the temporary
  4433.    directory. This if fixed;
  4434.  
  4435.  ■ Removed a number of invalid error-messages;
  4436.  
  4437.  ■ Removed a number of spelling errors;
  4438.  
  4439.  ■ Removed a (big) number of cosmetic errors;
  4440.  
  4441.  ■ Removed some  beeps and bells  that would drive  the user crazy.  The
  4442.    warnings and information from FileDoor  to the user is now  much more
  4443.    relaxed;
  4444.  
  4445.  ■ Trash  could  be  entered  in  all  log-files  and FILES.BBS. Even  a
  4446.    truncate to 64K or less was possible. This has been fixed;
  4447.  
  4448.  ■ Some  protocol calls  would crash  if there  were no extra parameters
  4449.    given. Also some protocols could  not be found in these  cases. These
  4450.    routines are rewritten;
  4451.  
  4452.  ■ FileDoor would  feel very happy  when trash was  on the command-line.
  4453.    Now all command-line  options are tested  and the SysOp  is mutilated
  4454.    if there is a wrong command-line option;
  4455.  
  4456.  ■ Comments  in the  info-file would  show the  download-counters. These
  4457.    are now removed (the counters, and only in the information-files);
  4458.  
  4459.  ■ You  won't  believe  it  but  there  have been a lot of reports  from
  4460.    Sysops who complained that user  would enter 'Y' on the  warning 'ARE
  4461.    YOU THERE'  (caused by  a time-out  from the  user). This would cause
  4462.    the next file to be selected. This has both been fixed.  The  message
  4463.    is  more  clear  AND  the  keyboard/modembuffer is flushed before the
  4464.    user can go on;
  4465.  
  4466.  ■ Changed a lot of misleading and incorrect text into better verbs;
  4467.  
  4468.  ■ Upload descriptions  could include spaces  at the end,  causing users
  4469.    to enter 'Shit                        ' and FileDoor to validate  the
  4470.    text. Now FileDoor  will truncate (trim)  all spaces (front  and end)
  4471.    before counting the  length of the  comment (it is  still possible to
  4472.    enter 'Shit.......................');
  4473.  
  4474.  ■ After  FileDoor did  write inside  a FILES.BBS,  that FILES.BBS would
  4475.    have a new date and time. This is now fixed, the original date,  time
  4476.    and attributes will be the same;
  4477.  
  4478.  ■ If a user entered a description before the actual upload while  using
  4479.    Bimodem AND a comment was  also send thru Bimodem itself,  the latter
  4480.    would prefer. This has been reversed;
  4481.  
  4482.  ■ A problem with uploads at midnight is fixed;
  4483.  
  4484.  ■ Fixed  a problem  with the  AlternateFILESpath. It  always pointed to
  4485.    the SYSTEM directory, whatever you supplied. Fixed;
  4486.  
  4487.  ■ Fixed  a  problem  where  only  normal files (not READ-ONLY or  other
  4488.    attributes)  could  be  selected.  CD-ROM  files  are read-only, thus
  4489.    fixed;
  4490.  
  4491.  ■ When  using  [V]iew  on  a  non-archive  file would report a  strange
  4492.    error. This has been fixed;
  4493.  
  4494.  ■ The pause (5 seconds) between  the termination of a transfer and  the
  4495.    continuation  of  FIleDoor  is  not  engaged  when  the  carrier  has
  4496.    dropped;
  4497.  
  4498.  ■ Fixed  a  security  leak.  Though  ..\USERS.BBS  could be given  when
  4499.    selecting downloads,  it was  impossible to  download the  file.  The
  4500.    new ExternalView  option made  it possible  to VIEW  the file, so the
  4501.    leak is closed;
  4502.  
  4503.  
  4504.  Replaced features:
  4505.  ───────────────────────────
  4506.  
  4507.  ■ The -DB  command-line parameter is  removed. Please remove  the menus
  4508.    that use  this parameter  and convert  the Bimodem  entries ('B')  to
  4509.    either Upload ('U'), Download ('D') or both ('D' and 'U');
  4510.  
  4511.  ■ The  HB  and  MB  parameters  for  ANSASC are now obsolete or have  a
  4512.    different meaning (see ANSASC option);
  4513.  
  4514.  ■ The  [direction] 'B'  in the  PROTOCOL option  is now  obsolete. Look
  4515.    into the previous lines for conversion suggestions;
  4516.  
  4517.  New/enhanced features:
  4518.  ───────────────────────────
  4519.  
  4520.  ■ Added the %B and %K macros for the log-layout, to be replaced by  the
  4521.    number of bytes or KBytes of the specific file;
  4522.  
  4523.  ■ Added  the ^M  macro for  the log-layout,  to be  replaced by a CR+LF
  4524.    sequence;
  4525.  
  4526.  ■ Added support for QuickBBS 2.75 (FILECFG.DAT);
  4527.  
  4528.  ■ Added ALT-key support for  FileDoor (local side), see the  chapter on
  4529.    local keyboard interfaces;
  4530.  
  4531.  ■ Added option (LockPassword) to be able to lock the local keyboard;
  4532.  
  4533.  ■ The  info-file (when  selected at  startup) is  now added by FileDoor
  4534.    even if the user did not supply /INFO. Only when there is still  room
  4535.    left for a fill to add (batch-protocols);
  4536.  
  4537.  ■ Added the SelMax option for small-housed (memory) computers;
  4538.  
  4539.  ■ Added  the UserPath  option for  Sysop-to-user files.  Also added the
  4540.    FileUSER and FileMAIN programs to make it all work;
  4541.  
  4542.  ■ Just before the  start of the protocol,  the user will now  see which
  4543.    files are added by FileDoor (info-files, added by sysop);
  4544.  
  4545.  ■ Tags in the UserMacro options are now enhanced to 8 positions;
  4546.  
  4547.  ■ Files in the UserMacro options can now be outside the BBS-areas.   In
  4548.    this  case  you  must  supply  a  drive  and directory along with the
  4549.    filename;
  4550.  
  4551.  ■ Added a new log-file (for  private uploads). Can be set with  the new
  4552.    PVTUploadLog option in FILEDOOR.CFG;
  4553.  
  4554.  ■ Added the  USAGE option that  works in combination  with the PROTOCOL
  4555.    option(s);
  4556.  
  4557.  ■ Added support  for BADFILES.CTL and  FILES.CTL. Use the  FILEDOOR.CFG
  4558.    options BADFILESName and FILESCTLName;
  4559.  
  4560.  ■ Expanded the TimeOut option with the HANG parameter;
  4561.  
  4562.  ■ FileDoor will now expand  all filenames and directories when  needed.
  4563.    You can now supply paths without drives, relative directories and  so
  4564.    on (only for those options that explicitly need full path);
  4565.  
  4566.  ■ You  can now  return from  the 'start  protocol' menu  to the 'select
  4567.    file menu' when needed;
  4568.  
  4569.  ■ Added  line-tags in  FILEDOOR.CFG. You  can now  use ONE FILEDOOR.CFG
  4570.    with all information for all the different BBS-lines;
  4571.  
  4572.  ■ FileDoor  will now  format and  display all  +-comment lines when you
  4573.    ask [I]nfo for a specific file;
  4574.  
  4575.  ■ Added option (ExternalChat) to trigger an external chat-program  with
  4576.    ALT-C;
  4577.  
  4578.  ■ Added option (AddFile) to add files to the selected files  (download)
  4579.    from the Sysop side. This can be commercials and such;
  4580.  
  4581.  ■ Added option (UploadName)  to add the name  of the user in  FILES.BBS
  4582.    for every uploaded file. This has been implemented in several ways;
  4583.  
  4584.  ■ Added option (DelOldFiles) to delete uploaded files with a date  that
  4585.    is lower than the supplied  limit (FileDoor will look INSIDE  archive
  4586.    files);
  4587.  
  4588.  ■ Support is  added to update  the USERON.BBS (under  RA, see also  the
  4589.    UserOnPath option);
  4590.  
  4591.  ■ Support  is added  for LiveSystems  USERON.EXE program  (see also the
  4592.    LiveSystemsPath option);
  4593.  
  4594.  ■ Added  a  status-bar  on  the  local  side  (extended and in  RA/QBBS
  4595.    format). Also added the new StatusLine option in FILEDOOR.CFG;
  4596.  
  4597.  ■ Added a huge number of  new ANS/ASC files (see included examples  and
  4598.    the description of the ANSASC option);
  4599.  
  4600.  ■ The can now be up to 5 DefaultExtension options;
  4601.  
  4602.  ■ Added  routines to  set the  DSZLOG environment  variable from within
  4603.    FileDoor itself. Can be shut off with the new NoOwnDSZLog option;
  4604.  
  4605.  ■ Enhanced  the ULMultiply  option so  FileDoor can  now CREDIT  upload
  4606.    time (finally);
  4607.  
  4608.  ■ Added  a windowed  shell to  the protocol.  This will  mean that  the
  4609.    status-bar  can  be  protected  (not  updated)  by FileDoor while the
  4610.    protocol is running;
  4611.  
  4612.  ■ For some  operations FileDoor would  report 'Testing ....'.  This has
  4613.    been enhanced with  a status-bar, so  the user can  see the progress.
  4614.    These can be  toggled with the  NoDupeStat and NoFindStat  options in
  4615.    FILEDOOR.CFG;
  4616.  
  4617.  ■ Because FileDoor is unable to interpret the one-zillion of  different
  4618.    extended-ANSI codes (used by the  BBS to be replaced by  fancy things
  4619.    as names, times and such),  the GOODBYE screen could be  displayed as
  4620.    trash. You can now overrule the name of this screen to one that  does
  4621.    not contain these codes;
  4622.  
  4623.  ■ When  only  one  protocol  is  available, FileDoor will not show  the
  4624.    protocol menu  unless a  special option  is set  in FILEDOOR.CFG (the
  4625.    new option MenuIfOnlyOne);
  4626.  
  4627.  ■ Added support  (finally) to make  it possible to  download a specific
  4628.    file with  FileDoor. Also  the default  protocol can  be set  in this
  4629.    case, though I advise  you to let the  user make a choice.  With this
  4630.    option (-F and  -X command-line parameters)  you can now  make one or
  4631.    more specific menu entries  to download the allfiles,  the BBS-manual
  4632.    and such.  It is  also possible  to download  a whole  range of Sysop
  4633.    pre-selected files when you include wildcards;
  4634.  
  4635.  ■ Added  support  to  overrule  the  log-file name and location with  a
  4636.    command-line parameter (-L);
  4637.  
  4638.  ■ Added  new  option  (ForceEdit)  to  force  the  user  to  check  the
  4639.    previously entered comment again after the upload;
  4640.  
  4641.  ■ Added a  new macro to  the protocol statement  ($!) to stop  the time
  4642.    while the protocol is shelled;
  4643.  
  4644.  ■ If the user inputs filenames  for uploads, they are also recorded  in
  4645.    the local BIMODEM.PTH file;
  4646.  
  4647.  ■ Added  new option  (BBSMAFormat, same  format as  BBSUPFORMAT). It is
  4648.    used by  FILEUSER.EXE and  FILEMAIN.EXE (not  by FILEDOOR.EXE).  Only
  4649.    the %R, %T and ^M macros will work with this option;
  4650.  
  4651.  ■ The NewFilesMacro has two new  options. The first will deside if  the
  4652.    tag will be displayed at startup. The second will deside if the  user
  4653.    is  able  to  search  only  certain  areas for new-files (it will ask
  4654.    questions for each area);
  4655.  
  4656.  ■ Added  new  option  (NoShowInternalMacros)  which  can  be used in  a
  4657.    combination with the  UserMacro and NewFilesMacro  to show all,  some
  4658.    or none of the available macros;
  4659.  
  4660.  ■ Added new  option (Verify) which  can be used  to trigger the  verify
  4661.    files option in Bimodem;
  4662.  
  4663.  ■ CheckDupes is now enhanced. You can supply a security level at  which
  4664.    (or above) the user  will not get a  dupe-check on a file  (CoSysops,
  4665.    special users);
  4666.  
  4667.  ■ Added  a  special  protocol  type  for HSLink-alike protocols. It  is
  4668.    called BiDSZ  and can  be used  in combination  with a PROTOCOL/USAGE
  4669.    option;
  4670.  
  4671.  ■ A  message  (please  wait)  befor  the  call  to the protocol is  now
  4672.    displayed;
  4673.  
  4674.  ■ The  /NEW macro  is enhanced  and will  now ask  if the user wants to
  4675.    search from the last time on or from a different date;
  4676.  
  4677.  ■ Duplicate Unwanted file-masks are now removed. Also when an  unwanted
  4678.    file in BADFILES.CTL or FILES.CTL diplicates, these are also  removed
  4679.    from the list (only one is shown);
  4680.  
  4681.  ■ Descriptions of the UserMacro option can now be 50 bytes long;
  4682.  
  4683.  ■ Added support for GIF, GIFLite and JPEG files;
  4684.  
  4685.  ■ After  the protocol  has finished,  FileDoor will  not check the time
  4686.    anymore unless a new transfer is engaged. This will make it  possible
  4687.    to handle  all actions  in a  normal way,  even if  there is  no time
  4688.    left;
  4689.  
  4690.  ■ Added new option (Delete0byteFiles) to remove any uploaded file of  0
  4691.    bytes (optional);
  4692.  
  4693.  ■ Added  a new  macro ($N)  to the  ExitAfterUploadx options.  If it is
  4694.    present in  the command-line,  FileDoor will  ONLY call  the exit  if
  4695.    there really are uploaded files;
  4696.  
  4697.  ■ Added new parameters (RA11 and QNEW) to the SYSTEM option. RA11  must
  4698.    be used for Remote Access 1.1x and QNEW for QuickBBS 2.75+;
  4699.  
  4700.  ■ Added  new  option  (NoLogoff).  Can  be  used  in  combination  with
  4701.    NoLastChance  and  AskAnother.  If  set,  there  is now way to logoff
  4702.    (normally) from FileDoor;
  4703.  
  4704.  ■ Added  new option  (ExternalView) with  support for  an external view
  4705.    program (MTS 7.59 and up);
  4706.  
  4707.  ■ Added  new  option  (DelAfterDL)  to  delete certain files after  the
  4708.    actual download. Can be used for temporary files like the files  from
  4709.    offline mail-readers and the DOWNLOAx.xxx files from MTS;
  4710.  
  4711.  ■ Enhanced the [I]nfo option with various download times and speed  for
  4712.    different modem speeds and protocols;
  4713.  
  4714.  ■ Added new option  (ExitMasks) to make it  possible to call the  exits
  4715.    after the uploads ONLY when specific files were received;
  4716.  
  4717.  ■ Added support for external  conversion programs that change the  name
  4718.    of the uploaded file(s) (like DISP's MTA.EXE);
  4719.  
  4720.  ■ Added support  for external conversion  programs to extract  comments
  4721.    from archives (like FILE_ID.DIZ) and  to pass them to FileDoor  (like
  4722.    DISP's MTA.EXE);
  4723.  
  4724.  ■ Added  new option  (InternalOverUser) to  overrule comments  from the
  4725.    user by comments from the archive;
  4726.  
  4727.  ■ Added  support  for   DISP-compatible  wildcards  (=SCAN)  and    for
  4728.    4DOS-compatible wildcards (*SCAN*.*);
  4729.  
  4730.  ■ Added  new option  (ExcludeFile) to  exclude local  and global  files
  4731.    (like FILES.BBS and others) from the file-selection;
  4732.  
  4733.  ■ Added an  overlayed version of  FileDoor which consumes  100K less of
  4734.    conventional memory;
  4735.  
  4736.  ■ Enhanced  the HideFiles  option to  allow users  to select files that
  4737.    are not in FILES.BBS if they supply the EXACT name;
  4738.  
  4739.  ■ Enhanced the DownloadHours option  with an optional baudrate for  the
  4740.    lowest allowed connect;
  4741.  
  4742.  ■ Added  new  option  (UploadHours).  Is  used  as DownloadHours  (also
  4743.    possible with baudrates) but now for uploads;
  4744.  
  4745.  ■ Added a lot of new internal coding, changes in layouts, fixes for the
  4746.    highest  possible  speeds  and so on. It is well possible that I even
  4747.    forgot to include  some  comments  on new/changed features but I have
  4748.    tried to include as much as possible;
  4749.  
  4750.  ■ Did a (almost) complete rewrite of the documentation;
  4751.  
  4752.  ■ Synchronized all ANS/ASC files and menus to the example  FILEDOOR.CFG
  4753.    and FILEDOOR.MUL files;
  4754.  
  4755.  
  4756.  5.4 Copyright, Trademarks
  4757.  ───────────────────────────────────────────────────────────────────────
  4758.  Bimodem       is a trademakr of Eric Labs
  4759.  4Dos          is a trademark of J.P. Software / R.C. Conn and T. Rawson
  4760.  DSZ and GSZ   is a trademark of Omen Technology
  4761.  Bimodem       is a trademark of Eric Labs
  4762.  HSLink        is a trademark of Samuel H. Smith
  4763.  FrontDoor     is a trademark of J. Homrichhausen
  4764.  SBBS          is a trademark of Risto Virkkala and Aki Antman
  4765.  MSDOS         is a trademark of Microsoft(tm)
  4766.  Windows       is a trademark of Microsoft(tm)
  4767.  QuickBBS      is a trademark of Pegasus Software
  4768.  Remote Access is a trademark of Continental Software
  4769.  USERON        is a trademark of LiveSystems
  4770.  OS/2          is a trademark of International Business Machines (IBM)
  4771.  PCDOS         is a trademark of International Business Machines (IBM)
  4772.  
  4773.  FileDoor  is  written  in  Turbo  Pascal  6.0,  with  help of the Turbo
  4774.  Debugger 2.5 and  makes extensive use  of Object Professional  1.14 and
  4775.  OPCFI 12.01.   Also included are  some routines of  TurboPower's ASYNCH
  4776.  Professional  1.04,  the  SYSTEM.TPU  is  replaced  with  a  registered
  4777.  commercial release of SYS60a  and also STRG61 (registered,  commercial)
  4778.  is included. Sources have been  edited  with  Brief <tm>, documentation
  4779.  has been edited with an old version of Multi Edit <tm>.
  4780.  
  4781.  Turbo Pascal        is a trademark of Borland International
  4782.  Turbo Debugger      is a trademark of Borland International
  4783.  Object Professional is a trademark of TurboPower Inc.
  4784.  ASynch Professional is a trademark of TurboPower Inc.
  4785.  OPCFI               is a trademark of Robert W. van Hoeven
  4786.  FileDoor            is a trademark of Robert W. van Hoeven
  4787.  MTA, MTS and RFW    is a trademark of Robert W. van Hoeven
  4788.  SYS60a              is a trademark of Eagle performance Software
  4789.  STRG61              is a trademark of Eagle performance Software
  4790.  Brief               is a trademark of SolutionSystems
  4791.  Multi Edit          is a trademark of American Cybernetics
  4792.  ==================== END OF DOCUMENT ==================================
  4793.